Apparat, Inc. takes great pleasure in presenting NEWDOS/80 Version 2.0, a Disk 
Operating System for the TRS-80 Model I and Model III computers. The following 
is an attempt to meet an ever increasing demand for information on our Disk 
Operating System. The information presented here by no means discusses every 
feature available nor explains every command. We attempt only to mention the 
more outstanding features. 

Almost all disk based computer systems use a Disk Operating System (known as 
DOS) to provide a software interface between the user program performing disk 
I/O and the actual disk drives and their controllers. Usually these operating 
systems perform many other functions as well, such as controlling what the user 
program is executing and the allocation of disk files and file space. Believe 
it or not, the primary function of a DOS is to make life easier for the compu- 
ter users and programmers . 

NEWDOS/80 Version 2 (released August, 1981) is one of a number of Disk Operat- 
ing Systems that operate with the TRS-80 and is the replacement for NEWDOS/80 
Version 1 (released June, 1980) and for NEWD0S/21 (released March, 1979). 
NEWDOS/80 Version 2.0 is designed to operate on the TRS-80 Model I and the 
TRS-80 Model III. A particular NEWDOS/80 Version 2 master diskette is tailored 
to operate only on one of the two TRS-80 models; if you wish to operate on both 
the Model I and the Model III yon must purchase different NEWDOS/80' s for each. 

^^ "The TRS-80 model being used must have at least 32K of RAM and at least one 5 
W'' ■*" 1/* inch, single sided, 35 (40 for the Model III) track disk drive (mounted on 

^ drive 0). 

A FEW OF THE NEWDOS/80 FEATURES INCLUDE: 

1. Single and/ or double density operation supported. 

2. Single and/ or double sided drive whose diskettes are treated as a 
single volume. 

3. 80 Track disk drives can read 35/40 track diskettes. 

4. Mix and match 35, 40, 77 and 80 track disk drives. 

5. Single density 8" disk drives supported; double density if CPU speed 
is equal to or greater than 3.55 MHZ. 

6. CPU speeds to 4 MHZ ok. (CPU slow down, if required, is NOT supported 
by NEWDOS/80). 

7. Lower case, blinking cursor and repeat key software built-in. 

8. Model I to/from Model III file portability under NEWDOS/80 Ver. 2.0. 

9. Enhanced copy features (28 different parameters available). 

10. Single drive, two diskette file/diskette copy. 

11. Copy to or from Model III or Model I TRSDOS diskettes, but will not 
directly operate with TRSDOS Model III or Model I 2.3B diskettes. 

12. MINI-DOS (allows DOS commands while user program is executing). 

13. SUPERZAP (a diskette display and modify program). 

14. DIRCHECK (validates directory integrity) . 

15. Built in RENUMber, variable REFerencing. 

16. Enhanced BASIC functions including five hew disk I/O file structures. 

17. Dynamic MERGing, DELETing, variable passing. 

********* 
NEWDOS/80 Version 2.0 ($149.00) may be purchased from your local dealer or 
directly from Apparat, Inc., 4401 S Tamarac Parkway, Denver, CO 80237. 
Phone (303) 741-1778 or (800) 525-7674. 



DISK BASIC, BOM I/O EEHARCEHERTS 
GEMERAL FEATURES 

**,T2£™ f BASIC allW8 the U8er to paas '"•*« - '«^i« 

^d'br^y^ 8 my d " able thC BREAK key VU *»"BMtt, H » and reenable it by 

that^he SSiToiTi T6Xt ,^ ne de i ete8 » the KETO0S / 8 ° DISK BASIC requires 
tnat the DELETE or D command be used to delete a Text Line. 4 

CMDMoscwl" 

Allows the user to execute ALL DOS commands from a. BASTT t,™,...- a, 

call extended KEWDOS/80 DISK BASIC commands. Program. Also used to 

The following is a listing of extended KEWDOS/80 DISK BASIC commands: 

^ variables!"' 8 "^ ™ 8 " e With ° Ut affeCtin * or clearing the 
ERASE Allows the specified variables to be cleared. 

ESte i\]Zl ! h % B J? eif " d variables to be kept; all others are cleared. 
DELETE Allows text lines from a specified line number to a specified line 
number to be deleted during program execution. 8 P ecitled Une 
swap Swapping of variable contents. 

88 tiin*?'*?"!!"?"'* t0 8teP thr0Ugh a * ro « r « one lin * at a 

S^f!° J! beginning or starting with a specified line number, 

«™ ,l ?J ; h V ending Une nu * ber « ^ «PPer right hand * 
corner of the display. 

Main memory sort allowing direct and indirect sorting of up to 9 
arrays. Ascending or descending order may be specified. 



Reinstate a program deleted by the command NEW. 
BASIC 

BASIC may be entered using part or all of the following parameters: 
BASIC, N > M,mnj»filespec" or BASIC,N,M,LOAD"filespec" 

Till" ^'not'w.SSS °^ fi l%* r ?". t0 , ba " 8erVed ' and M flet » BASIC '« memory 
size. If not specified, the default is 3 file areas and DOS's HIMEM value. 

The following direct commands are recognized: 

. (Period) Lists current text line. 

down-arrow Lists the next text line. 

up-arrow Lists the previous text line. 

; or ahift-up-arrow List the first text line. 

/ or shift-dowa-arrow List the last text line. 

: Scroll one page toward the start of the text. 

« Scroll one page toward the end of the text. 

> Edit the current text line. 



A or a Auto line numbering. DI Move line nl to line u2. 
D or d Delete line number(s). DD Duplicate line nl at line n2. 
E or e Edit line number. 
L or 1 List line number(s). 

MERGE 

MERGE will merge either an ASCII or a packed text file. It may be executed as 
a direct statement, or as a BASIC program statement (loading an overlay text 
code section and continuing execution without disturbing the variables). 

RBTOM 

The current BASIC program or a part of it may be renumbered while it resides in 
the text area. 

REF 

The BASIC statement REF allows the BASIC programmer to find all places in the 
program where a line number, an integer, a variable, a string, a function code, 
a packed sequence of characters, or an unpacked sequence of characters is 
referenced. A complete reference table may be generated at any time going to 
the display or to the printer. 

DISK BASIC I/O ENHAMCEHBXTS 

The TRSDOS standard file structures (SEQUENTIAL or PRIKT/IHPUT and RANDOM or 
FIELD ITEM) are supported as well as two new file structures called MARKKA ITEM 
and FIXED ITEM. For marked item and fixed item fileB, the programmer GETs or 
PUTs an item-group of data at one time. The only limitations on the amount of 
data transmitted are file size and, if applicable, record size. Logical 
records can be any length between 1 and 409i bytes. The special functions 
designed for field item file ops, <MKD$, MKI$, MKS$, CVD, CVI, CVS, LSET, RSET, 
etc.) function as before. However, the use of MKD$ , MKI$, MKS$, CVD, CVI, and 
CVS may be dropped for marked item or fixed item file operation as GET and PUT 
will transmit numeric as well as Btring data. 
The FI file types are : 

MI A marked item file not segmented into records. 

MD A marked item file segmented into records of varying lengths, where 
the length is determined by searching for either EOF or the 
next record's Start Of Record item. 

MF A marked item file segmented into fixed length records. 
The FF file types are : 

FI A fixed item file not record segmented. 

FF A fixed item file of fixed length records. 

The five new file types (MI, MU, MF, FI, FF) may be used sequentially or ran- 
domly except that MI and FI types cannot be updated. MU Records can only be 
updated if the new record length is not greater than the old record length. 

The Be new file types (The choice of which is up to the user) are initially 
difficult to understand, but once understood, make file I/O both easier and 
more flexible. The manual has two appendices to assist the user's education 
into the use of these file types. 



BOS LIBRARY COWARDS 



APPEHD Append one file onto the end of another. 

ATTRIB Assign attributes to a file. 

AUTO Define the DOS command to be executed at reset. 

BASIC2 Activate non-disk BASIC (Model I only). 

BLXHK Enable/ disable cursor blinking. 

BOOT Reset the computer. 

BREAK Enable/disable the BREAK key. 

CHAIH Shift to keyboard input from disk. 

GHNON Alter chaining state* 

CLEAR Clear user memory, routesj timer and logical sequences. 

CLOCK Display the time every second. 

CLS Clear the display. 

COPY Copy single or multiple files or a full diskette. 

CREATE Pre-allocate a disk file. 

BATE Set computer's date. 

DEBUG Enable/disable the DEBUG facility. 

BIR Display a diskette's directory information. 

DO Shift to keyboard input from disk. 

BUMP Dump memory contents to disk. 

ERROR Display DOS error message. 

FORMAT Format a diskette for use with the NEWDOS/80 system. 

FORMS Set printer parameters (Model III only). 

FREE Display free granule count of each mounted diskette. 

BIMEM Set DOS's high memory value. 

JKL Send current contents of display to the printer. 

KILL Delete a file. 

LC Set keyboard a-z toggle switch to the specified state. 

LCBVR Lower case driver. 

LIB Display NEWDOS/80 library commands. 

LIST List a text file on the display. 

LOAD Load a Z-80 machine language file into RAM. 

MDBORT Terminate MINI-DOS and return to main program. 

MDCOPY Copy a file while under MINI-DOS. 

MDRET Exit from MINI-DOS and return to main program. 

PAUSE Display message and pause on ENTER. 

PDRIVE Assign default attributes to a physical drive. 

PRMT List a text file on the printer. 

PROT Alter some diskette control data. 

PURGE Selectively KILL files from a diskette. 

R Repeat the previous DOS command. 

RERAME Rename a file. 

ROUTE Route one device to or from another. 

SETCOM Set RS-232C interface parameters (Model III only). 

STMT Display specified message. 

SYSTEM Change system. 

TIME Set the real time clock. 

VERIFY Require verify read after every disk write. 

HRDIRP Write directory sectors protected. 



DOS FEATURES 

JKL 

Is a routine for dumping the contents of the display screen to the printer. 
This allows the operator to print information that would otherwise be lost as 
soon as the display is used for something else. This function may be invoked 
from DOS by simultaneously depressing the keys, J, K and L or by execution of 
the DOS command "JKL". 

HIHI-DOS 

There are many times when, during the execution of a main program, the operator 
would like to momentarily exit the main program, execute one or more of the DOS 
library commands and then resume main program execution without any change 
having occured to the main program's state during the exit. This can be 
accomplished via MINI-DOS. To enter MINI-DOS simultaneously depress the keys 
D, F and G. Three MINI-DOS commands are added to the library, MDRET (return 
from MINI-DOS), MDCOPY (copy files), MDBORT (abort and return to NEWDOS/80 
READY). 

CHAIRING 

This function is invoked via the DOS commands CHAIN or DO. For most TRS-80 
users there are functions which use the same series of DOS commands and/ or 
program responses, and for each of these functions it would save a lot of key 
stroking, operator time and errors if this keyboard character sequence could be 
saved in a disk file to be called upon when the operator wishes to execute a 
specific function. A chain file may be sectioned, allowing the use of one file 
to hold many separate JCL files, thus minimizing disk storage. Message with 
pause may be inserted in the chain text. Comment lines are allowed within the 
chain text. Message lines can be displayed. Branching to other chain file 
sections is allowed. DOS commands CHNON Y, D and N can be embedded in the 
chaining text. 

RUN OHLY 

Is a feature that allows the programmer to create turnkey programs in which 
data input and output is controlled by the program (i.e., BASIC, ASSEMBLER, 
COBOL, etc.). MINI-DOS, DEBUG, JKL, the CLEAR key, and the BREAK key may be 
disabled, 

DEBUG 

As an aid primarily for the machine language programmer but also for use by 
higher level language programmers, NEWDOS/80 includes an improved DEBUG facil- 
ity for interrupting current execution, inspecting memory, altering memory, 
inspecting disk, altering disk, single step execution, etc. DEBUG may be 
entered by simultaneously depressing the three keyboard keys 1, 2 and 3. 

DOS-CALL 

NEWDOS/80 allows any machine language program to call the DOS routine at 441 9H 
to execute a DOS command or user program. BASIC also uses this command to 
execute the CMD"doscnid" function. 



SUPPLIED HEWDOS/80 UTILITIES 



SUPERZAP (Machine coded) 



This handy utility provides the user with the means to read and write standard 
256 hyte diskette sectors or any part of main memory, except writing to ROM. 
Superzap will locate for display/update any sector of a file regardless of 
whether the file sectors are contiguous or spread throughout the diBk. 

Verify Disk Sectors will allow superzap to check each sector for parity errors. 

Zero Disk Sectors lets the user "zero out" disk sectors. 

Copy Disk Sectors lets you copy contiguous disk sectors from one disk to 
another or to itself. 

Copy Disk Data lets the user copy up to 651)35 bytes anywhere on the disk or to 
another diskette. 

Display Password Encode will take a password, encode it and display the 
resulting encode in hexidecimal as it would appear in a directory FPDE. 

Display Hame/Type Hashcode command of SUPERZAP will take the name and extension 
of a filespec and display the resulting hashcode in hexidecimal as it would 
appear in the directory HIT table. 

DIECHECK (Machine coded) 

This module tests and lists the target diskette's directory. If errors are 
found in checking the directory, they are listed before the directory listing 
of active files. It also allows the option of cleaning up (not repairing) the 
directory, and, as an aid to moving single density diskettes back and forth 
between the Models I & III under HEWDOS/80, allows the option of writing the 
directory protected. The information presented may be listed to the printer or 
display. 

CHAIBBLD (Basic coded) 

A mini-text editor that simplifies the creation and modification of chain 
files. Allows inserting of new text lines, deletion of lines, extending of 
existing text lines, duplication of existing text lines, relocation of text 
lines . 

EDTASM (Machine coded) 

We have converted Radio Shack's original Model I tape Editor Assembler to work 
with disk, 15 line page scrolling on the display, liBt symbols in alphabetical 
order with reference list, accept upper and lower-case, display the total 
number of bytes left in the text area so the user can judge his approach to 
symbol table overflow or text buffer overflow. Use of this program requires 
the user be an owner of Radio Shack's original tape Editor Assembler (1978). 
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DISASSEMBLER 2.0 (Machine coded) 

This is a utility supplied with NEWDOS/80 2.0 which disassembles Z80 code from 

a standard TRS-80 load module or from memory. The disassembled code is sent to 

the display or to the printer. Generated source text may be sent to disk and a 
location cross table may be generated. 

When source is routed to disk it is converted to EDTASM format. The disassem- 
bler will reference all Jump Relative (JR) commands. 

IMOFFSET (Machine coded) 

This utility reads a tape or disk load module (CMD), displays its load infor- 
mation, optionally changes the program's load area, optionally attaches an 
appendage enabling the program at execution time to move itselt from its load 
area to its execution area, optionally prepares the module to run under non- 
disk BASIC via SYSTEM, and stores the module onto disk or tape with a new name. 

ASPOOL (Machine coded) 

Written by H. S. Gentry and modified by APPARAT to operate with NEWDOS/80 and 
to self relocate. This program will automatically direct your printer output to 
disk files, and then automatically print it on the printer. It will print in 
the background while your foreground main program is executing provided the 
main program every second or so either sends a byte to be spooled or checks the 
keyboard for a new input character. 



ON GOIHG SUPPORT 

Apparat has, since the first NEWD0S/21 release, always provided continuous and 
ongoing support for its users. We provide this support by answering customer 
questions and providing written corrections, known as ZAPS, at no charge to the 
customer. Zaps are distributed by mail to all REGISTERED owners (only those 
who send their registration cards are registered) whenever a large number of 
zaps have been accumulated. 

When Apparat receives a registration card, the latest copy of the zaps will 
soon thereafter be mailed to the registered owner. This lets the owner know 
that Apparat has received the registration card and provides the owner with any 
zaps generated since either that manual (containing zaps as chapter 13) was 
made up or that NEWDOS/80 diskette was created. Apparat has an original disk- 
ette update service for those users who would prefer that Apparat apply the 
zaps. This service is performed ONLY on the MASTER diskette for a $10.00 
service and handling charge. 



DOS ROUTIMKS - FOR ASSEMBLY LANGUAGE PROGRAMMERS 



402DH Ho Error Exit. 

4030H Error-already-dieplayed DOS Error Exit. 

4400H Ho-Error Exit. 

440 5H Enter DOS and execute a command. 

4409H DOS Error Exit. 

440DH Enter DEBUG. 

4410H Enqueue a user timer interrupt routine. 

4413H Dequeue a user timer interrupt routine. 

4416H Keep drives rotating. 

4419H DOS-CALL Execute a DOS command and return. 

441 CH Extract a filespec. 

4420B Open a FCB to new or existing disk file. 

4424H Open a FCB to a existing file. 

4428H Close a FCB. 

442CH Kill FCB's associated file. 

4430H Load a program file. 

4433H Load and commence execution of a program file. 

4436H Read sector or logical record from disk. 

4439H Write sector or logical record to disk. 

443CH Write sector or logical record to disk with verify read. 

443FH Position FCB to start of file. 

4442H Position FCB to specified file record. 

4445H Position FCB back one record. 

4448H Position FCB to EOF. 

444BH Allocate File Space. 

444EH Position FCB to specified RBA. 

4451H Write EOF value from the FCB to the directory. 

445BB Select and power up the specified drive. 

445EH Test for mounted diskette. 

4461H *name routine enqueue. 

4464H *name routine dequeue. 

4467H Send message to the display. 

446AH Send message to the printer. 

446DH Convert clock time to HH:MM:SS character format. 

4470H Convert the date to MM/DD/YY character format. 

4473H Insert default name extension into filespec. 

0013H Read a byte from a disk file. 

001BH Write a byte to a disk file. 

447BH Model III only (performs the same as Model I 4410H). 
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REGISTRATION NUMBER 92SMM 

rrcwDCSoG 

FORTHETRS-80 

MODEL! 

MICROCOMPUTER 



Apparat Incorporated takes pleasure in presenting NEWDOS/80, 
Version 2.0. Above is the registration number of your NEWDOS/80. 
This registration number must be the same as the registration 
number you find on your diskette label and the enclosed registration 
card. If they are not, return them to the dealer from whom you 
purchased your NEWDOS/80 to be reissued. This registration Num- 
ber is your assurance of receiving any corrections or minor revisions 
to NEWDOS/80 that may be released. The registration card should 
be completed and returned to Apparat at your ealiest convenience. 
PLEASE RETURN THE CARD IT IS IMPORTANT! It is our only 
method of determining who has purchased this copy of the system. 
This number shoud be included in ail correspondence with Apparat. 




Apparat, Inc. 

4401 So. Tamarac Parkway • Denver, Colorado 80237 
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NOTICE 

NEWDOS/80 is distributed on an "AS IS" basis only and without 
warranty. Neither Apparat Inc. nor any authorized dealer of 
NEWDOS/80 shall have liability or responsibility to any person 
or entity with respect to any liability, loss or damage caused 
or alleged to be caused by the computer programs constituting 
NEWDOS/80, including but not limited to any interruption of 
service, loss of business or anticipitory profits or consequen- 
tial damages resulting from the use or operation of such 
computer programs. 

Good programming practices dictate that frequent backup copies 
be made to protect active files. Also, valued data should not 
be used under an unknown system until it has been thoroughly 
tested. 



All rights reserved. Reproduction or use, without express 
written permission, in any manner, is prohibited. No liability 
is assumed with respect to the use of nor for any damages that 
may result from the use of any information contained herein. 



All NEWDOS/80 software is copyrighted by Apparat Inc., who 
authorizes each NEWDOS/80 owner the right of duplicating the 
contents of the NEWDOS/80 diskette, provided such duplication 
is for the sole personal use of said owner. Any other 
duplication of NEWDOS/80, in whole or in part, is strictly 
prohibited. 
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1. INTRODUCTION. 

1.1. Registration. 

As soon as you receive your NEWDOS/80, fill out and mail the registration card. 
Apparat will limit its assistance and patches (zaps) to registered owners only. 
In your" communications with Apparat, always state your name, address and your 
NEWDOS/SjS's registration number. For Version 1 of HEWDOS/80 we had many com- 
plaints of not receiving zaps from users who had not sent in the registration 
card. Apparat does not require the owner to agree to anything when filling out 
the NEWDOS/80 Version 2 registration card; just let us know who you are. 



1.2 Trademark Credits. 

Throughout this manual certain trademarked names will be used to refer to those 
trademarked products. Since our printers do not have the tm symbol, we will 
acknowledge the trademarked names here. If we have missed rendering an ac- 
knowledgement, please forgive us as we do not mean for any trademarked name to 
be used to refer to anything that the trademark holder does not mean it to 
refer to. In some cases, such as VTOS, the primary manual for that system 
shows the name trademarked but does not say who it is trademarked to. 

1. TRS-80 is a registered trademark of Radio Shack, Inc. 

2. TRSDOS is a registered trademark of Radio Shack, Inc. 

3. VTOS is a registered trademark. 

4. LDOS is a registered trademark of Lo bo Drives International. 

5. DOUBLER is a registered trademark of Percom Data Company, Inc. 

6. SCRIPSIT is a registered trademark of Radio Shack, Inc. 



1.3. What Is Apparat' s HEHDOS/80 Version 2? 

Almost all disk based computer systems use a Disk Operating System (known as a 
DOS) to provide a software interface between the user program performing disk 
I/O and the actual disk drives and their controllers. Usually these operating 
systems perform many other functions as well such as controlling what user pro- 
gram is executing and the allocation of disk files and file spacer Believe it 
or not, the primary function of a DOS is to make life easier for the computer 
users and programmers. NEWDOS/80 is one of a number of DOSs that operate with 
the TRS-80; in this case only the Model I and Model III are supported. 

NEWDOS/80 Version 2 is the replacement for NEWDOS/80 Version 1 that was re- 
leased in June, 1980 and for NEWDOS/21 that was released in March, 1979. 
NEWDOS/80 Version 2 is a disk operating system designed to operate on the 
TRS-80 Model I and the TRS-80 Model III. A particular NEWDOS/80 Version 2 
master diskette is tailored to operate on only one of the two TRS-80 models; if 
you wish to operate on both the Model I and the Model III, you must purchase 
different NEWDOS/80' s for each. The TRS-80 model being used must have at least 
32K of RAM and at least one 5 inch, single sided, 35 (40 for the Model III) 
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track disk drive (mounted on drive 0). Model I NEWDOS/80 Version 2 is distri- 
buted on a 35 track, single sided, single density diskette, and Model III 
NEWDOS/80 Version 2 master diskette is distributed on a 40 track, single sided, 
double density diskette* You must have a disk drive capable of handling the 
master diskette. 

NEWDOS/80 Version 2 for the Model I and NEWDOS/80 Version 2 for the Model III 
are mostly downward compatible with NEWDOS/80 Version 1, NEWDOS/21 and Model I 
TRSDOS 2.3, but it will be necessary to maintain certain programs with differ- 
ent copies for all four systems for incompatibilities do exist. NEWDOS/80 
Version 2 is more incompatible with the Model III TRSDOS than it is with the 
Model I TRSDOS, and most programs and files will have to be maintained differ- 
ently in the two systems. In the past, while TRSDOS was largely dormant, 
attempts were made to limit the incompatibilities between NEWDOS and TRSDOS, 
but now that TRSDOS is being actively updated more and more incompatibilities 
are appearing between the two systems. TRSDOS is going one way; NEWDOS/80 is 
going another. If this limits and eventually destroys NEWDOS r s usefulness to 
the users, so be it. NEWDOS cannot and should not exist to be a mirror image 
of TRSDOS; if the user wants that, then please use TRSDOS. NEWDOS was acci- 
dently created in the huge vacuum left by Model I TRSDOS, has always incorpo- 
rated features not in TRSDOS and, in Version 2, has not implemented many of the 
newer features of the Model III TRSDOS, Chapter 12, sections 12.1 through 12.5 
give some of the incompatibilites of KEWDOS/80 Version 2 with NEWDOS/80 Version 
1 and with the Model I and III TRSDOSs. 

The DOS and DISK BASIC portions of NEWDOS/80 are total rewrites from that of- 
fered in NEWDOS/21. The requirement that the user purchase TRSDOS as a pre- 
condition of use of NEWDOS/21 is not required for NEWDOS/80. It is still 
recommended that the user purchase TRSDOS, and NEWDOS/80 users are expected to 
have purchased the TRSDOS manual and be knowledgeable of its contents as use of 
NEWDOS/80 assumes this user knowledge. Users of the EDTASM module are still 
required, as a precondition of use of NEWDOS/80 r s EDTASM, to have purchased 
Radio Shack's tape editor/assembler. 

Though NEWDOS/80, Version 2 was tested more extensively than Version 1, there 
will still be errors, and many programs will require at least a zap to work 
with NEWDOS/80 Version 2. Error reporting procedures are discussed in chapter 
11, and the outstanding zaps are in chapter 13. 



1.4. Duplicate and Specify the System. 

NEWDOS/80 is not a simple system. When the NEWDOS/80 user is ready to ini- 
tially use NEWDOS/80, he/she should spend one to two hours studying the docu- 
mentation before doing anything with the NEWDOS/80 diskette. 

When ready, put a write protect tab on your NEWDOS/80 Version 2 master disk- 
ette. Then power up your computer, place the master diskette in drive and 
press reset. The NEWDOS/80 banner should appear optionally followed by re- 
quests for date and time. If date and time are requested, please give realis- 
tic values. Next, NEWDOS/80 READY will be displayed to indicate DOS is waiting 
for something to do. 
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It is good practice to never mount on a disk drive the NEWDOS/80 master disk- 
ette except to make copies of the diskette and to very carefully apply manda- 
tory zaps (see chapter 11). When zapping, you should first apply the zaps to a 
working Version 2 system diskette and test them out before applying them to the 
master diskette. Keep the master diskette stored away in a safe place; do not 
keep it in your NEWDOS/80 manual and do not use it in normal operations. 4 
Apparat will not replace a lost master diskette though it will, under the termB 
for the diskette update service offered in section 11.9, replace a damaged 
diskette. 

Enter, via the keyboard, the DOS command: 

LIB 

A list of all the DOS library commands will be displayed to you. These com- 
mands are defined in chapter 2 with examples. 

Enter the DOS command: 

DlM.S.I 

A list of all the files on the NEWDOS/80 Version 2 master diskette will be dis- 
played. These files, except for NWD82V2/ILF and NWD82V2/XLF, are discussed in 
chapter 5. 

Enter the DOS command: 

SYSTEM, 

NEWDOS/80 offers the user certain system options which are specified via the 
DOS library command SYSTEM (see section 2.46) and activated during each compu- 
ter reset. The DOS command SYSTEM, you just executed has displayed the state 
of all SYSTEM options, and you should compare these value carefully against the 
specifications. You may decide that your system is to use different SYSTEM 
specifications. You may change them now if absolutely necessary; otherwise you 
should wait until after you have made a few backup copies of the master disk- 
ette. Whenever you decide to update the master diskette, don't forget to take 
off the write protect tab. 

Enter the DOS command 

PDRIVE.0 

HEWDOS/80 can operate with a limited mixture of disk drive and interface types. 
The characteristics of each of the physical drives 0-3 must be specified to 
the system via the DOS library command PDRIVE (see section 2.39). These char- 
acteristics are then read by DOS during each computer reset. The PDRIVE com- 
mand you just executed has displayed the existing drive specifications plus 6 
pseudo drive specifications. You may want to change the specifications for one 
or more drives. You may do so now if absolutely necessary; otherwise you 
should wait until you have a few backup copies of the master diskette. 

Now you must make three or more copies of the NEWDOS/80 Version 2 master disk- 
ette. If possible, perform these initial backups without changing any of the 

SYSTEM or PDRIVE parameters. If not possible, change them the minimum neces- 
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sary and do a reset when done. You should carefully study sections 2.14, 2.39 
and 2.46. 

NEWDOS/80 does NOT have a BACKUP module; format 5 or 6 of DOS library command 
COPY (see section 2.14) is used instead. For each of the backups you are about 
to do, the master diskette is both the system and the source diskette while the 
destination diskette is the diskette to contain the new working copy of the 
NEWDOS/80 system. Some examples of the COPY command you will use to make 
copies of the NEWDOS/80 Version 2 master diskette are: 

COPY, 0, 0, ,FMT, USD For a single drive system where the master and copy 
diskettes have the same PDRIVE characteristics. 

COPY, 0,1,, FMT, USD For a multiple drive system where the master and 
copy (mounted on drive 1) diskettes have the same PDRIVE characteristics. 

COPY, 0,0,, FMT, USD, CBF,DPDN=4 For single drive system wherein the 
destination diskette has PDRIVE characteristics different from the master 
diskette. You must have previously altered the master diskette PDRIVE 
specification for drive 4 (remember to use the A option or to reset the 
computer after changing the drive 4 specification). 

COPY, 0,1,, FMT, USD, CBF For a multiple drive system where the drive 1 
drive will be moved to drive after the copy and the destination drive 
has different PDRIVE characteristics than does the current drive 0. You 
must have previously altered the master diskette's PDRIVE specification 
for drive 1. 

Each system diskette has its own set of SYSTEM and PDRIVE characteristics. 
Therefore, for each working copy of NEWDOS/80 Version 2 you make, after the 
copy is completed, you need to set that system diskette's SYSTEM and PDRIVE 
characteristics for the operating conditions it is to operate with. 

The NEWDOS/80 owner is authorized to make as many copies as necessary of the 
NEWDOS/80 diskette or individual programs thereon for his/her own personal use. 
NEWDOS/80 owners and users are specifically prohibited from copying the 
NEWDOS/80 diskette or individual programs thereon for use by others. See COPY, 
formats 2 and 4, in section 2.14. 



1.5. Apply Outstanding Zaps. 

Before your NEWDOS/80 is ready to run user programs, review the outstanding 
zaps to both NEWDOS/80 modules and to other modules (such as EDIT/CMD and 
SCRIPSIT) that require patches to work properly with NEWDOS/80. Chapter 11 
explains how to apply zaps (patches), and with your NEWDOS/80 should have come 
a chapter 13 which contains the zaps. If part or all of chapter 13 is not in 
the proper place in the manual, please put it there. Mandatory zaps must be 
applied; optional zaps are at user discretion. 

Mandatory zaps to NEWDOS/80 modules should be applied to all copies of the 
NEWDOS/80 Version 2 master diskette and to the NEWDOS/80 Version 2 master 
diskette. DO NOT start applying the zaps until you have at least 2 or 3 good 

backup copies made of the NEWDOS/80 diskette. 
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1.6. Comence Using HEHDOS/80. 

Once all backup copies of the HEWDOS/80 Version 2 system are made, zaps appli- 
ed, system options and drive characteristics specified, you are now ready to 
use NEWDOS/80. 

Put away the master diskette and mount in drive one of the system diskette 
just made. Then press reset to re-initialize DOS using the new diskette. 
NEWDOS/80 READY will then appear. The user may now type in a DOS command, 
which is either a DOS library command as discussed in chapter 2 or the name or 
name/ext of a user program to be loaded and run. If a user program does not 
have a name extension, name extension CMD is assumed. Examples: 

BASIC causes the load and execution of program BASIC/CMD. 

SCRIPSIT/LC causes the load and execution of program SCRIPSIT/LC. 

If the DOS library command or the user program requires or allows for parame- 
ters within the DOS command, one or more spaces or a comma must follow the 
command name and precede the parameter(s) . Examples: 

BASIC.5,65000 
DIR 1 A 

For virtually all programs to be executed under NEWDOS/80, there are instruc- 
tions on how to use the program that usually comes with the program when you 
buy it. For NEWDOS/80 program modules, the instructions are in chapter 6 ex- 
cept for BASIC which is covered in chapters 7 and 8. 

Those users upgrading from NEWDOS/80 Version 1, NEWDOS/21 or TRSDOS to 
NEWDOS/80 Version 2 should read sections 12.1 through 12.5 carefully. 



1.7. Apparat Thanks Its Beta Testers. 

Over forty persons throughout the United States and Canada were involved in the 
testing of NEWDOS/80 Version 2, finding errors, suggesting enhancements and 
providing criticism. Apparat and the KEWDOS/80 author thank each one of these 
beta testers for the long hours spent working with the three beta releases that 
were sent out. It is Apparat's policy that each beta tester receive a compli- 
mentary copy of the final release of NEWDOS/80 Version 2. 
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2. DOS LIBRARY COMHATOS. 



2.1, Notation Conventions and General Information. 



All DOS commands terminate with an ENTER. In subsequent specifications, the 
ENTER is not shown, but the user is to supply it. 

DOS commands are limited to a total of 80 characters, including the concluding 
ENTER. 

U A set of brackets are used to enclose an optional parameter. When using 
the optional parameter in a DOS command, the [1 are not included. 

Example: 

[ ,PROT=xxx] [ ,ASE=yn] [ ,ASC-yn] 
could be coded as 

,PROT=READ,ASC=N 

Upper case A - Z and non alphanumeric characters are to be included exactly as 
shown. See the above example. 

Lower case letters or words with or without trailing decimal digits. These 
represent prototype values for which the user is to substitute the appropriate 
actual values. See the above example. 

In some cases where the prototype will be replaced by one and only one char- 
acter, the prototype word contains, in lower case, all the characters legal for 
that value. This helps serve as a reminder of which characters are legal re- 
placement for that prototype value. For example, if ASC=Y and ASON are the 
only two legal ASC values, then the prototype will usually be written as 
ASC=yn. 

Where commas are used in DOS commands, they may be replaced by one or more 
consecutive spaces. 

Numeric values without a suffixed B are considered decimal values unless 
otherwise specified. Hexadecimal values must be suffixed with an H unless 
otherwise specified. Example: 

4000H and 16384 are the same value. 

When specifying a disk file, the terra 'filespec' is used. A filespec is of the 
form : 

namel[/extl][.passwordl][ :dnl] 

Parameters must be specified in the above order. 

namel is the file's name consisting of 1 - 8 chars of which the first must 
be A - Z and the others A - Z or - 9. 

extl is the name extension (i.e., CMD, BAS, OBJ, CIM, TXT, DOC, COM, etc.) 
which classifies a file. A file need not have a name extension, but if it 
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does it must be 1 - 3 chars of which the first must be A - 2 and the 
others A - Z or - 9. Ifa file has a name extension, all filespecs re- 
ferencing the file must include the name extension, unless a default name 
extension is provided for (i.e., /CUD). 

passwordl is 1 - 8 chars of which the first must be A - Z and the others A 
- Z or - 9. Passwordl is the value given to both the access and update 
passwords for a file when it is created. Passwordl is value used in 
password checking when an existing file is opened. Passwordl is required 
in a filespec if passwords are enabled and the file has passwords assign- 
ed; otherwise it is not. 

dnl is the drive # of the drive which has the diskette containing the 
file. Examples: 

MYFILE80/BAS.YOURPW80:0 
MYFILE:3 

YOURFILE.YOURFW 

NEWDOS/80 will accept lowercase in all DOS library commands and any further 
input that might be queried for. 

For each DOS library command, the command keyword is stated along with a brief 
definition. Next, if the command is allowed parameters, a prototype of the 
command is given, listing all required and optional parameters. Next comes 
explanations of the command, parameters and options. Lastly, some examples of 
the DOS command are given. 

For documentation ease, the prototype command is sometimes shown spread over 
multiple lines in this document; however, the user should consider each command 
as one contiguous statement. 

Unless otherwise stated, a DOS library command is executable under MINI-DOS 
(see section 4.2). 

NEWDOS/80 differs from TRSDOS in NOT using parenthesis to enclose parameters. 
In NEWDOS/80 version 1, parenthesis around the operands were optional for 
BREAK, CLOCK, DEBUG, DIR, PROT, and VERIFY; they are NOT allowed in version 2. 

In the same vein, version 1 allowed the keywords ON or OFF to be used instead 
of Y or N in the DOS commands BREAK, CLOCK, DEBUG and VERIFY; this is NOT 
allowed in version 2. 
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2.2. APPEND Append one file onto the end of another. 

APPEND, filespecl, [TO, 3 filespec2 

This command will append the file filespecl onto the end of the file filespec2. 
The EOF from file filespec2's directory FPDE determines the point at which file 
filespecl is appended. This may be trouble if file filespec2 had explicit EOF 
characters, such as in BASIC program files or assembler source files. 
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File filespecl is not altered. The original contents of file filespec2 are not 
altered; the file is only added to. 

APPEND is not executable under MINI-DOS. 

APPEND examples: 

1. APPEND,XXX:1,YYY/DAT:0 The contents of file XXX on drive 1 are 
appended onto the end of file YYY/DAT which is on drive 0. 

2. APPEND AAA TO BBB The contents of file AAA are appended onto the 
end of file BBB. DOS searches the currently mounted diskettes to find 
both files. 



2.3. ATTKIB Assign attributes to a file. 

ATTRIB,filespecl[,INV] [ ,VIS] [ ,PROT=xxx] [ ,ACC=passwordl] [ ,UPD-password2] 
[ ,ASE=e] [ ,ASC=c] [ ,UDF=u] 

This command assigns attributes to the filespecl file. At least one of the 
optional parameters must be specified. 

If passwords are enabled in your system, then filespecl must specify the 
existing update password, if any, for that file. 

1NV gives the file the invisible attribute. Unless the I option is specified 
in DIR, the file will not be listed by DIR. 

VIS takes away the invisible attribute, whether the file had it or not. 

PROT=xxx specifies the access level to be used during file I/O if passwords are 
enabled (see system option AA) and the access, not the update, password was 
used to open the file. The levels are defined for values of xxx as: 

LOCK Level 7. No access allowed to the file at all, except by the 
system's overlay loader. 

EXEC Level 6. Access allowed only to execute the file as a program. 
BASIC will require either RUN or LOAD with R option, and will disable the 
BREAK key, thereby preventing the user from stopping the RUN and disal- 
lowing direct statement execution. 

READ Level 5. Access allowed for execute or to read the file's con- 
tents. 

WRITE Level 4. Access allowed for execute, read or write of the file. 

RENAME or NAME Level 2. Access allowed for execute, read, write or to 
rename the file. 

KILL Level 1. Access allowed for execute, read, write, rename or to 

kill the file. 
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FULL Level 0'. All operations are allowed on the file. 

ACC=passwordl Passwordl is assigned as the access password for the file. If 
null, a value of all blanks is assumed; otherwise the value must be 1 - 8 
characters with the 1st = A - Z and the others A - Z or - 9. Assigning the 
access password via this parameter of ATTRIB is the only way that will enable 
use of the PROT=xxx protection and then only if the access password is differ- 
ent from the update password. If a password is specified when the file is 
created, it is assumed both the update and the access password, and the update 
password has priority at open time. If passwords are enabled, the password 
specified in the filespec at open time is not the update password, and it is 
the access password, the current protection level is stored into the FCB for 
later use by the DOS read, write, load, etc. routines. Subsequently, if an 
access is attempted in violation of the access level, 'ILLEGAL ACCESS TRIED TO 
A PROTECTED FILE' error will occur. 

0PD"password2 Password2 is assigned as the update password for the file. 
The update password is of the same configuration as the access password. Dur- 
ing file open where passwords are enabled, the password specified in the file- 
spec is checked first against the file's update password. If they match, then 
FULL access is allowed to the file. 

ASE=e where e is either Y or N. This parameter has been added to allow DOS 
to automatically allocate diskette space to a file if ASE=Y or to disallow 
further allocation if ASE=H. ASE=Y is the default condition when a file is 
created. 

AS&=c where c is either Y or N. This parameter has been added to allow DOS 
to automatically deallocate file diskette space beyond the EOF during a CLOSE 
operation if ASC^Y is specified, and to disallow this deallocation if ASC=N. 
ASC-Y is the default setting when a file is created. 

DDF^u where u is either Y or N. This parameter has been added to mark the 
file as updated if UDF=Y is specified or to clear the updated mark if UDF=N is 
specified. The DOS system marks a file as updated whenever it is about to up- 
date a 6ector to that file and it finds the file's directory entry not marked 

as updated. 

ATTRIB command examples : 

1. ATTRIB, XXX/CMD:1,UPD=ZXCVB,ACC=NMLKJ,PR0T=EXEC Assigns to file 
XXX/CMD located on drive 1 the update password ZXCVB, the access password 
RMLKJ and protection level 6 which allows the program to be executed but 
not read or written to. Since the filespec XXX/CMD :1 did not specify a 
password, we must assume that either password checking was disabled 
(SYSTEM option AA=N) or the file did not have an update password prior to 
the ATTRIB command. 

2. ATTRIB YYY/DAT.OZBV IKV ASE=N ASC=N UDF=H This command tests if 
file YYY/DAT has update password QZBV, and if so, assigns the file the 
invisible attribute, flags that extra space allocation and excess space 
deallocation are not to be allowed, and lastly clears the file's updated 

flag. 
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ADTO - BASIC2 - BLIMK 

2.4. AUTO Define the DOS command to be executed at reset. 

AUTO[,doscmd] 

This command allows the user to specify a 1 - 31 character DOS command to be 
invoked automatically at reset time. This command is stored in the last 32 
bytes of GAT sector of the current system diskette. 

If doscmd is not specified, then a null command is stored in the GAT sector to 
indicate to reset/power-on that no AUTO command exists. 

If SYSTEM option AB = N and BC = Y, by pressing ENTER during reset, the auto 
command in the GAT sector will be ignored, and the system will go to DOS READY. 

AUTO is useful to the user who usually executes the same command or chain of 
commands (Bee CHAIN, sections 2.9 and 4.3, and DO, section 2.19) at reset time. 
By setting system option AB=Y or BO=H, the user is forced to this command or 
chain of commands, thus allowing the person(s) controlling a computer to re- 
strict the activity of users of the computer. 

AUTO command examples: 

1. AUTO BASIC RUN"XXX/BAS" causes subsequent reset/power-ons to 
activate BASIC and to start the execution of the BASIC program XXX/BAS. 

2. AUTO DO RSACTION causes subsequent reset/power-ons to activate 
chaining from file RSACTION/ JCL, thus executing the DOS and other program 
commands contained therein. 

3. AUTO causes subsequent reset/power-ons to go to the normal DOS 
READY, awaiting the next DOS command to be inputted from the keyboard. 



2.5. BASIC2 Activate non-disk BASIC (Model I only). 

This command puts the system into non-disk BASIC. NEWDOS/80 is no longer in 

the system. 



2.6. BLIHK Enable/ disable cursor blinking. 

BLINK [,yn] 
BLINK or BLINK, Y Blinking of the display cursor is turned on. 

BLINK, N Blinking of the display cursor is turned off. 

SYSTEM option BH can be used to set the cursor blinking state at reset/ 
power- on. 
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2.7. BOOT Reset the computer. 



On the Model I, this command deselects the drives and then executes Z-80 in- 
struction HALT, which causes both a hardware and a software reset. For the 
Model III, since HALT does not cause a hardware reset, this instruction causes 
a jump to location to execute a software reset. 



2.8, BREAK Enable/ disable the BREAK key. 

BREAK[,yn] 

BREAK or BREAK, Y The BREAK key is enabled as a normal input key (hex- 
adecimal code 01) until the next normal DOS READY, when it is set according to 
system option AG. 

BREAK ,H The BREAK key is disabled as a normal input key until the next 
normal DOS READY, when it is set according to system option AG. 

The BREAK command is useful for those programs that want the BREAK key enabled, 
and enable it via a DOS-CALL (vector 441 9H). The same applies to programs that 
definitely want BREAK disabled. NOTE: Executing BREAK from DOS READY is use- 
less since the immediate return to DOS READY resets the BREAK key according to 
system option AG. 

In NEWDOS/80 the BREAK key may also be enabled by storing a 0C9H byte in Model 
I location 4312H (Model III lbcation 4478H) and may be disabled by storing a 
0C3H byte in that location. In HEWDOS/80 version 1, the break key was also 
manipulated by changing bit 4 of location 4369H (Model I only); in version 2 
for the Model I, setting or clearing this bit does nothing and is harmless. 
However, programs on the Model III must NOT alter that bit, as that location is 
now in the system buffer. 



2.9. CHAM Shift to keyboard input from disk. 

CHAIB, filespecl[ ,sectionid] 

DOS command DO performs exactly the same as CHAIN. 

The purpose of the CHAIN command is to cause a predefined set of characters to 
be treated as input from the keyboard. This predefined set of characters has 
been previously stored in the file filespecl. 

The CHAIN command places NEWDOS/80 in chaining mode, if not already there. The 
file filespecl is opened. If sectionid is not specified, the file is posi- 
tioned at the beginning. If sectionid is specified, the file is searched for 
the matching sectionid record, leaving the file positioned at the byte follow- 
ing the section ID record. 

Subsequently, input that is supposed to come from the keyboard comes from the 
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chain file until chaining is terminated by the encounter of either end of file 
or end of section or until chaining is temporarily halted by the execution of 
the DOS command CHNON, N. 

Keyboard data is input from the chaining file in one of two modes. 

If SYSTEM option AT = N, chaining operates in record mode. In this mode, 
whenever NEWDOS/80, BASIC or any program requests a new record from the 
keyboard via the standard ROM keyboard record input routine at 05D9H, the 
record will come from the chain file. Any other requests for keyboard 
input are honored from the keyboard and not the chain file. 

If SYSTEM option AT = Y, chaining operates in byte mode. In this mode, 
all requests for keyboard input characters via the standard keyboard input 
routine are honored from the chain file. 

The CHAIN command may be issued via DOS-CALL or via BASIC'S CMD function. When 
so, DOS does not immediately return to the calling program but instead contin- 
ues to execute commands from the chain file until either end of file, end of 
section, command CHKON,K or command CHNON, Y is encountered. 

CHAIN is not legal under MINI-DOS. 

The chain file creator/maintainer is responsible for assuring that chaining 
does not create impossible situations for the system or user programs. 

NEWDOS/80 cannot have more than one chain file active at a time. If the new 
DOS command from the current chain file is itself a CHAIN or DO command, pro- 
cessing in the current file ceases and the new chain file is opened, becoming 
the new current chain file. 

When the system opens a chain file, name extension in the filespec defaults to 
JCL if the filespec doesn't give one. 

CHAINING is discussed further in section 4.3. 

CHAIN or DO command examples: 

1. CHAIN, XXX:f5 Chaining starts at the beginning of file XXX/JCL:0. 

2. DO YYY/CHN:1,QQQ Chaining starts at the first byte of the chain 

section named QQQ within file YYY/CHN. 



2.10. CHNOH Alter chaining state. 
CHNON , ynd 

The CHNON command is used during chaining. An error will occur if a chain file 
is not currently open. A CHNON command should not be the last entry in an un- 
sectioned chain file or the last entry in a chain file section as the command 
will be meaningless. 
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CHNON.N The current position within the chain file ie remembered and chain- 
ing is temporarily suspended so that subsequent keyboard characters to come 
from the keyboard. If chaining was being done under DOS-CALL, the current DOS- 
CALL level is exited. 

CHNON,Y causes subsequent keyboard characters to come from the chain file, 
starting at the current position within the chain file. If CHNON,Y was exe- 
cuted as a DOS-CALL, the current DOS-CALL level is exited. 

CHHOK,D causes subsequent keyboard characters to come from the chain file, 
starting at the current position within the chain file. If CHHON,D was exe- 
cuted as a DOS -CALL, DOS remains at that level and executes subsequent commands 
from the chain file until either CHNOH.Y or CHKON,N or end of section or end 
of file is encountered. 

See sections 2.9 and 4.3 for further discussion of chaining. 



2.11. CLEAR Clear user memory routes, timer and logical enqueues. 

CLEAR[ ,START=addrl ] [ ,END=addr2] [ ,MEM=addr3 ] 
The CLEAR command performs the following functions: 

1. Performs ROUTE, CLEAR DOS command function. 

2. Dequeues all user routines in the timer interrupt routine chain that 
were enqueued by the 4410H (Model I) or 447BH (Model III) call to DOS. 
This includes turning the clock display off. 

3. Dequeues all *name routines that were enqueued by a 4461H call to DOS. 
This includes the NEWDOS/80 spooler, if active, but not its graceful ter- 
mination. The spooler, if in use, should be fully terminated before 
executing CLEAR. 

4. Resets HIMEM to addr3 or, if addr3 not specified, to the highest 
memory address. 

5. Zeroes memory from addrl or 5200H, which ever is greater, through 
addr3 or HIMEM, whichever is lower, addrl must be greater than or equal 
to 5200H and less than or equal to addr3. 

CLEAR command examples: 

1. CLEARjSTART-e^^H.MEM^DFFFH All routes are cleared, and all 
timer and *name routines dequeued. HIMEM is set to 0DFFFH. The main 
memory between 6000H and 0DFFFH is zeroed. 

2. CLEAR All routes are cleared, and all timer and *name rou- 
tines dequeued. HIMEM is set to the highest main memory location, and all 
memory from 5200H to HIMEM is zeroed. 
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2*12. CLOCK Display the time every second. 
CLOCK[,yn] 

CLOCK or CLOCK, Y The current value of the clock is displayed every 
second in positions 53-60 of the display's top line in HH:MM:SS format. 

CLOCK, N The displaying of the clock ceases. 

Users are warned that the clock will continuously lose time. There is no hard- 
ware clock in the sense of seconds, minutes and hours. Computation of clock 
time is done from the 25ms interrupt chain in the Model I (in the Model III, 
it is done in the ROM from the timer interrupt). Whenever the interrupts are 
left off for more than 25ms (33 or 40 ms on the Model III) , one or more inter- 
rupts are lost and for each one lost, the clock loses 25ms (33 or 40 ms on the 
Model III). Lost interrupts are very frequent when disk I/O is being done, is 
massive when tape I/O is done, and can also be frequent if other routines hung 
off the 25ms chain are more than a few milliseconds long. 



2.13. CLS Clear the display. 

CLS simply clears the display, resetting it to 64 character mode. On the Model 
III, reserved top display lines are not cleared. 



2.14. COPY 

The COPY command is used to copy a single file, multiple files or a full 
diskette. COPY has 6 formats: 

1. COPY,filespecl[ ,T0] ,filespec2E ,SPDN=dn3] E ,DPDN=dn4] 

2. COPY,$filespecl[,TO],filespec2[,SPDN=dn3][,DPDN=dn4] 

3. COPY, [ : Jdnl ,filespecl [ ,T0] ,filespec2[ ,SPDN=dn3] [ ,DPDN=dn4] 

4. COPY, [ : ]dnl ,$f ilespecl [ ,T0] ,f ilespec2[ ,SPDN=dn3] [ ,DPDH=dn4] 

5. COPY, [ : ]dnl [«tcl] [ ,T0] , [ : ]dn2[«tc2] ,mm/dd/yy[ ,Y] [ ,N] 

[ ,NDMW] [ ,FMT] [ .NFMT] [ ,SPDN=dn3 ] [ ,DPDN=dn4] [ ,SPW=passwordl ] 
[ ,NDPW=password3 ] [ ,DDND] [ ,ODN=namel ] [ ,KDK] [ ,KDD] [ ,NM=name2] 
[ ,SN=name3 ] [ .USD] [ ,BDU] [ ,UBB] 

6. C0PY ) [:]dnl[ ) T0],[:]dn2[=tc2],mm/dd/yy,CBF[,Y][,N] 

[ .USE] [ ,/ext] [ ,UPD] [ ,ILF=filespec3] [ ,XLF-f ilespec4] [ ,CFWO] 
[ ,NDMW] [ ,FMT] [ ,KFMf] [ ,SPDN=dn3 1 [ ,DPDK=dn4] [ ,SPW=passwordl ] 
[ ,0DPW=password2] [ ,NDPW=password3] [ ,DDND] [ ,ODN=namel ] 
[ ,KDN] [ ,KDD] [ ,NDN=narae2] [ ,SN=name3] [ ,USD] [ ,UBB] 
[,DDSL=lnl][,DDGA=gcl] 

The COPY command has been significantly changed in NEWDOS/80 version 2; all 
users, new and old, should carefully read this section. 

COPY cannot be executed under MINI-DOS ; however for simple single file copies, 
DOS library command MDCOPY is available. 
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dnl and dn2 are drive numbers and may be equal. The colon preceding dnl and /or 
dn2 is optional. 

Filespecl is tbe source file's filespec. Filespec2 is the destination file's 
filespec. 

Filespecl prefixed with $ means that either the source or the destination file 
or both are to be on drive and are on diskette(s) that either (1) do not 
contain a NEWDOS/80 system identical to the one on drive when COPY was init- 
iated, (2) do not contain a NEWDOS/80 system, or (3) contain no system at all. 

During processing for formats 2, 3, 4, 5 and 6, the system may ask for various 
diskette mounts; do what the prompts ask! I 

1. When prompted for the system diskette, mount the NEWDOS/80 diskette 
that was on drive at the start of the COPY command execution. 

2. When prompted for the source diskette, mount the diskette containing 
file filespecl (formats 1, 2, 3 and 4) or the data to be copied (formats 5 
and 6). 

3. When prompted for the destination diskette, mount the diskette to 
contain file filespec2 (formats 1, 2, 3 and 4) or to receive the data 
being copied (formats 5 and 6). 

SPDM«dn3 Source PDrive Number. SPDK=dn3 tells the system that for all source 
drive I/O, the system diskette's PDRIVE specifications (see DOS command PDRIVE, 
section 2.37) for drive dn3 are to be used instead of the source drive's normal 
PDRIVE specifications. dn3 is a value to 9, referring to a drive number 
listed by the PDRIVE command. 

DPDB=dn4 Destination PDrive Number. DPDN=dn4 tells the system that for all 
destination drive I/Os, the system diskette's PDRIVE specifications for drive 
dn4 are to be used instead of the destination drive's normal PDRIVE specifica- 
tions. dn4 is a value to 9 referring to a drive number listed by the PDRIVE 
command. 

Note that use of SPDN and DPDN for a drive single drive COPY (formats 4, 
5 or 6) means that three different PDRIVE specifications (one for the sys- 
tem diskette, one for the source diskette and one for the destination 
diskette) will apply during the COPY even though only one drive is used. 

Format 1 is the single file copy. It is used to copy the contents of file 
filespecl to file filespec2. The diskette(s) involved in the COPY must already 
be mounted; the system gives no mount prompts. The contents of file filespecl 
are not altered. The previous contents of file filespec2, if any, are lost. 
If the leading part of filespec2 equals that of filespecl, filespec2 may be 
shortened by leaving off the leading part, the remainder of filespec2 starting 
with / or . or :. For example: 

COPY, USERFILE/DAT : ,T0 , USERFILE/DAT : 1 

can be shortened to: 

COPY,USERFILE/DAT:0,TO,:1 
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Remember, the keyword TO is optional, and spaces may be used instead of commas. 
Thus the command could be written: 

COPY USERFILE/DAT:0 :1 

Format 2 is the same as format 1 except that the $ sign prefixed onto file- 
specl indicates that a conflict exists with drive 0, the system drive, and DOS 
will prompt for the proper diskettes to be mounted on drive 0. If the source 
and destination drive numbers are both zero but the source and destination 
files are on separate diskettes, use format 4 instead of format 2. 

Format 3 again is similar to format 1, except that the user has only 1 drive 
available for the copy and file filespecl resides on a diskette different from 
that of file filespec2. Neither filespec can specify a drive number. DOS will 
prompt for the mount of the source and destination diskettes as they are need- 
ed. If drive is specified, both the source and destination diskettes must 
contain a NEWDOS/80 system identical to the one mounted on drive at the start 
of the COPY command; otherwise use format 4. 

Format 4 performs similar to format 3 except that either file or both reside on 
diskettes with different NEWDOS/80 systems, non-NEWDOS/80 systems or no systems 
at all. DOS will prompt for the mount of the system, source and destination 
diskettes as they are needed. Format 4 should only be used when dnl equals 0; 
otherwise you are wasting time with diskette swaps that are not needed. 

Formats 2 and 4 allows suppliers of programs, whether free or purchased, to 
send their program products on diskettes that do not contain HEWDOS systems. 
Aside from the supplier's programs and/or data files, the diskette need only 
contain the directory and the BOOT/SYS file, both created on each diskette 
during formatting. Suppliers must not include a NEWDOS system on their disk- 
ettes unless they have made explicit arrangements with Apparat. 

NEWDOS/80 does not have a diskette BACKUP program. Instead, either formats 5 
or 6 is used. Format 5 is a full diskette sector by sector copy without con- 
cern for the number and type of files. Format 6 copies some or all of the 
source diskette's files onto the destination diskette. Of the two, for the 
same amount of data transmitted, format 5 is faster while format 6 allows 
greater variation between source and destination diskette types and tries to 
reassign files to contiguous space. 

Format 5 is a full diskette copy. The default specifications for the two 
drives are the PDRIVE specifications currently being used by DOS. The drives 
must have the same number of sectors per track, granules per lump and sectors 
per granule (five is the current NEWDOS/80 standard); otherwise format 6 must 
be used. The destination diskette may have more tracks than the source; if so, 
the destination directory is adjusted to account for the extra free granules 
(not done if BDU option specified). Format 5 options are defined as follows: 

=tcl DOS is to use the value tcl as the source diskette's track count 
during the COPY rather than the source drive's default value. 

=tc2 DOS is to use the value tc2 as the destination diskette's track 
count during the COPY rather than the destination drive's default value. 

mm/dd/yy is the date to be placed in the destination diskette date 
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field. The mm/dd/yy may be null, and if so the system date is used., The 
only time mm/dd/yy may be entirely left out of the format 5 COPY command 
is when the command has only the two drive number parameters (example: 
COPY 1 ). Otherwise mm/dd/yy must be the 3rd parameter even if it is 
null or to be overridden by either the KDD or the USD parameter. If the 
mm/dd/yy is null, this must be so indicated by separating commas (not 
spaces) (example: COPY 1,,FMT CBF ). 

Y The user doesn't care what was previously on the destination disk- 
ette. Y is mutually exclusive with N, ODN, ODPW, DDND, KDN or KDD. Y is 
the default (for COPY) if none of its mutual exclusions are specified. 

N At the start of the COPY or FORMAT the destination diskette must not 
contain recognizable data, i.e., should be in a bulk erase state. COPY 
will be terminated if the diskette is found to contain data. N is mutual- 
ly exclusive with Y, ODN, ODPW, DDND, KDN or KDD. 

NDMW No Diskette Mount Waits. DOS is to assume that all needed disk- 
ettes are already mounted on the specified drives. No mount prompts or 
error prompts are displayed. If an error occurs that otherwise would have 
caused a prompt, the copy will be terminated. If NDMW is specified and 
neither FMT nor NFMT are specified, FMT is assumed. NDMW is intended for 
use when COPY (or FORMAT) is invoked via DOS-CALL (i.e., from BASIC) and 
the calling program does not want operator interaction. Since NDMW causes 
the COPY or FORMAT to bypass error and disk mount queries, it is recom- 
mended that NDMW normally not be used when the operator is keying in the 
COPY (or FORMAT) command. 

FMT Format. DOS formats the destination diskette before copying data. 
FMT is mutually exclusive with NFMT. If neither FMT or NFMT is specified 
and NDMW was not specified, the operator will be queried 'FORMAT DISKETTE? 
(Y OR N)'. If neither FMT or NFMT is specified and NDMW was specified, 
FMT is assumed. 

NFMT No Format. DOS does not format the destination diskette before 
copying data. The user must assure that the destination diskette is al- 
ready formatted correctly. NFMT is mutually exclusive with FMT. 

SFW=passwordl Source Password. If passwords are enabled (system op- 
tion AA = Y) and system option AR = N, then COPY requires a source disk- 
ette master password match. If passwordl does not match the source disk- 
ette's password, the copy function will be terminated. 

MDFW=password3 New Destination Password. Password3 must conform to 
rules for passwords and is assigned as the destination diskette's new 
password, NDPW is mutually exclusive with BDU. 

DDND Display Destination old Name and Date. The destination disk- 
ette's old name and date are prompted to the display, allowing the opera- 
tor to decide whether or not to proceed with the copy. DDND is mutually 
exclusive with Y, N, and NDMW. 

ODH=namel Old Destination Name. If the destination diskette's old 
name is not equal to namel , then the system prompts, allowing the operator 
to decide whether to proceed with the copy. ODN is mutually exclusive 
with Y, N and NDMW. 
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KDH Keep Destination diskette Name. The destination diskette keeps 
its old name rather than receive the source diskette's name. KDN is mu- 
tually exclusive with Y, N, BDU and NDN. 

KDD Keep Destination diskette Date. The destination diskette keeps 
its old date rather than receive the mm/dd/yy parameter from the COPY 
command. KDD is mutually exclusive with Y, N, BDU and USD. 

HDH=name2 Hew Destination Name. The destination diskette takes name2 
as its name, rather than receive the source diskette's name. Name2 must 
conform to the specification for diskette names. NDN is mutually exclu- 
sive with BDU and KDN. 

DSD Use Source Date. The destination diskette uses as its date the 
source diskette's date, rather than receive the mm/dd/yy parameter from 
the COPY command. USD is mutually exclusive with KDD and BDU. 

SN=name3 Source diskette Name. If the source diskette's name is not 
equal to name3 , a prompt is issued, allowing the operator to decide 
whether or not to proceed with the copy. 

BDD Bypass destination Directory Update. Aside for simply copying 
the source sectors onto the destination diskette, the format 5 COPY also 
updates the boot and PDR1VE data in the destination file BOOT/SYS and, as 
necessary, the name, date, password and extra granule information into 
file DIR/SYS. There are times, however, when this file updating is not 
wanted, and by specifying option BDU these updates are bypassed. BDU is 
useful when the source diskette has a bad directory, has a non-standard 
directory (such as a TRSDOS Model III directory) or has no directory at 
all or when the user wants a full diskette copy with no alterations. BDU 
is mutually exclusive with KDN, NDN, NDPW and USD. 

DKB Use Big Buffer In NEWDOS/21 and NEWDOS/80 version 1, COPY was 
restricted to using main memory below 7000H unless it was a two diskette, 
single drive COPY, in which case all of memory to HIMEM was used. If a 
user wanted to force the usage of all memory to HIMEM, the UBB parameter 
had to be specified. However, in NEWDOS/80 version 2, all of main memory 
to HIMEM is used unless the COPY was invoked under DOS-CALL (i.e., from 
BASIC), in which case only main memory below 7000H is used. Thus, in 
NEWDOS/80 version 2, UBB is a useless parameter left in existence only for 
upward compatibility from Version 1. 

Format 6 is the multiple file COPY and is distinguished from format 5 by the 
inclusion of the CBF (Copy By File) option. Though format 5 is the faster way 
to backup a diskette, format 6 offers more flexibility, allowing files to be 
copied between diskettes and drives of widely varying characteristics. The 
choice of files to be copied can be limited by the combined effect of options 
USR, /ext, UFD, ILF, XLF and CFWO; if one or more criteria are specified, only 
those files satisfying all the criteria are copied. Format 5's options, except 
BDU, are used in format 6 as well as the following additional options. 

If NFMT is specified, then none of Y, N, KDN, KDD, NDN, BDU, USD, NDPW, 
DDSL, DDGA or tc2 may be specified, ODPW may be required, and system files 
are not copied unless already existent in the destination file directory. 
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If NFMT is not specified, then the destination file is formatted as if the 
command was FORMAT, including establishing BOOT/SYS and DIR/SYS. Then, 
before any files are copied, all files to be copied are entered into the 
destination diskette's directory. This is necessary as system files must 
occupy the same directory FPDEs in order for DOS to work at all. 

CBF Copy By File CBF, required for and used only in format 6, ind- 
icates the copy will be done by files rather than in straight sequential 
order of diskette sectors. 

USR copy user files. Only user files are copied; system and invis- 
ible files are excluded. 

/ext copy files having name extension ext. Only files with name ex- 
tension ext are copied, ext is a to 3 character name extension. 
Examples of this parameter are /CMD, /, /BAS, /X. 

UPD copy updated files Only files that have the updated flag on in 
the source diskette directory are copied. This flag is turned on by the 
standard DOS sector write routine to indicate that at least one sector has 
been written or re-written to this file since the last time the updated 
flag was cleared. This flag is turned off by specific request via the 
PROT or ATTRIB commands and is NOT turned off by COPY. Since the standard 
DOS sector write routine is used to write the file's sectors to the des- 
tination diskette, the updated flag is turned on for the copied destina- 
tion files. 

ILF=filespec3 Include List File Filespec3 specifies a file containing 
a list of files to be copied. If a file is not in the list, it is not 
copied. It is not an error if an included file is not on the source disk- 
ette. Within the list, each file to copied is specified by its name/ext 
followed by a EOL char ( flDH) . If a specification begins with a semi- 
colon, it is bypassed as a comment. Each specification, except comment, 
is limited to a maximum of 13 characters, including the EOL. On reading, 
the file's bytes are modulated into the ASCII range to 127. The file 
can be made using SCRIPSIT, but the user must assure that no characters 
other than null C 00H) follow the last EOL character; SCRIPSIT tends to 
leave extraneous characters so a delete-to-end-of-text should be done. 
ILF is mutually exclusive with XLF. 

XLF=filespec4 Exclusion List File. The file filespec4 is the same 
structure as specified for ILF above and specifies the files to be ex- 
cluded from the COPY. It is not an error if an excluded file is not on 
the source diskette. XLF is mutually exclusive with ILF. 

CFWO Check File With Operator. For the qualifying files, DOS asks the 
operator, one file at a time, if the file is to be copied to the destina- 
tion diskette. Reply Y if the file is to be copied, reply N if not to be 
copied, reply R if to restart entire CFWO query sequence, or reply Q if no 
more files to be copied. No files are copied until the querying is com- 
pleted. 

0DPW=password2 Old Destination diskette Password. If NFMT is speci- 
fied, if passwords are enabled and if system option AR = N, then copy re- 
quires a destination diskette password match. If password2 does not match 
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the destination diskette's password, the copy is terminated. 

DDSL=lnl Destination diskette Directory Starting Lump. Formatting will 
start the directory on the 1st sector of lump lnl if DDSL is specified; 
otherwise the default starting lump number for the drive (see PDRIVE com- 
mand) will be used. DDSL is mutually exclusive with NFMT. 

DDGA=gcl Destination diskette Directory Granule Allocation. Formatting 
will allocate gel (value 2-6) granules to the directory if DDGA is 
specified; otherwise it will assign the default # of granules for that 
drive (see PDRIVE command). DDGA is mutually exclusive with NFMT. 

If during a format 6 COPY, the destination diskette has insufficient space to 
contain a file, "DISKETTE FULL = name/ext" is displayed and the destination 
file's EOF is set to 0. Though EOF is set to 0, any space the file may have 
allocated to it is not deallocated. 

A single drive format 5 or 6 COPY cannot be executed under DOS-CALL (i.e., from 
BASIC) since COPY under DOS-CALL restricts itself to main memory below 7000H 
and this would necessitate too many diskette Swaps. 

During a COPY or FORMAT where NDMW was not specified, pressing right arrow at 
any time will cause the function to pause, awaiting ENTER to continue or up- 
arrow to cancel. Pressing up-arrow at any time will terminate the function; 
however, be careful as the state of the destination diskette will be unknown, 
especially if the cancel conies during the actual formatting. 

The COPY command and standard 40 track, double density, single sided, 5 inch 
TRSDOS Model III diskettes may be used to transfer TRSDOS Model III diskette 
files into or out of the NEWDOS/80 system. There are a number of restrictions 
to this operation. 

NEWDOS/80 cannot be used to format a TRSDOS Model III diskette; however, 
once the user has a formatted empty TRSDOS Model III diskette, he/she may 
duplicate it repeatedly under NEWDOS/80 using format 5 COPY with the NFMT 
and BDU options, thus obtaining a stock of formatted, empty TRSDOS Model 
III diskettes. 

The user must assure that where the source and/or destination is a TRSDOS 
Model III diskette the proper PDRIVE specs are invoked, either implicity 
or directly by the SPDN and/or DPDN parameter (see PDRIVE command example 
3, section 2.37 for the exact PDRIVE specification). 

A file need not previously exist on a TRSDOS Model III diskette in order 
for it to be copied. NEWDOS/80 will allocate the proper directory entry 
and diskette space. 

Any of COPY formats 1, 2, 3, 4 or 6 may be used to copy files to or from 
TRSDOS Model III diskettes. Remember, FMT must not be specified. If 
format 6 is used and one of the source or destination is a TRSDOS Model 
III diskette, then files marked as SYSTEM files (FPDE 1st byte, bit 6=1) 
are NOT copied. 

Files copied between NEWDOS/80 and TRSDOS Model III are always readable 
though not necessarily usable on the receiving system. 
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Examples of COPY: 

1. COPY XXX:1 YYY:1 In this format 1 COPY, file XXX on the 
diskette already mounted on drive one is copied as file YYY on that same 
diskette. 

2. COPY,AAA,BBB:2 In this format 1 COPY, the currently 
mounted diskettes are searched for the file AAA. If found, it is copied 
as file BBB to the diskette already mounted in drive 2. 

3. -COPY SUPERZAP/CMD:0 :3 In this format 1 COPY, the file named 
SUPERZAP/CMD is copied from diskette already mounted in drive to the 
diskette already mounted in drive 3. Since the file name and name exten- 
sion are the same for both files, they were dropped from the second file- 
spec. 

4. COPY XXX;1 2 SPDN=9 In this format 1 COPY, SPDN=9 causes, for 
the duration of the COPY only, all source file I/O to assume that drive 1 
has the characteristics specified for drive 9 in the PDRIVE specifica- 
tions. If we assume that the PDRIVE drive 9 specifications were those for 
a Model III TRSDOS diskette (see PDRIVE example 3, section 2.37), this 
COPY will copy file XXX from the TRSDOS Model III diskette already mounted 
on drive 1 to the NEWDOS/80 diskette already mounted on drive 2. 

5. COPY SXXX:1,YYY:0 In this format 2 COPY, the destination 
diskette to contain file YYY is not the same diskette as was mounted on 
drive when the COPY command was initiated. DOS will ask for the mount 
of the destination and the system diskettes as it needs them. 

6. COPY,$XXX:0 YYY:1 In this format 2 COPY, the source diskette 
containing file XXX is not the same diskette as was mounted on drive 
when the COPY command was initiated. DOS will ask for the mount of the 
source and system diskettes as it needs them. 

7. COPY 1 XXX YYY/DAT In this format 3 COPY, the diskette con- 
taining file XXX is not the same diskette as the one to contain file 
YYY/DAT yet both the source and destination diskettes are to use drive 1. 
DOS will ask for the mount of the source and destination diskettes as it 
needs them. Note that, as required for format 3 and 4, neither filespec 
contains a drive number. 

8. COPY XXX/DAT /DAT In this format 3 COPY, file XXX/DAT on one 
diskette is to be copied as file XXX/DAT on another. Both diskettes are 
to be mounted on drive 0, and DOS will ask for them as needed. Since 
drive is used and this is format 3 rather than format 4, both the source 
and destination diskettes must contain NEWDOS/80 systems identical to that 
mounted on drive when the COPY command was initiated. 

9. COPY $XXX/DAT /DAT This format 4 COPY accomplishes essenti- 
ally the same thing as the previous example. The difference is that DOS 
assumes that neither the source nor the destination diskette contains the 
proper NEWDOS/80 system; so DOS will ask for the mount of the system, 
source and destination diskettes as it needs them. 
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10. COPY $XXX XXX SPDN-9 This format 4 COPY accomplishes the same 
thing as in example 4 above excepting that only drive is used. For the 
duration of this COPY, drive uses two sets of PDRIVE specifications. 
The standard drive specifications are used for the system and destina- 
tion diskette I/Os, and the system diskette's PDRIVE' s drive 9 specifica- 
tions are used for the source diskette I/Os. Note* in this example* the 
second filespec was not foreshortened as there was nothing to foreshorten. 

11. COPY 1 06/01/80 FMT This format 5 COPY is an example of one of 
the simplest and most commonly used forms of the full diskette COPY. This 
COPY copies one diskette to another using drive as the source drive and 
drive 1 as the destination drive. Default track counts for the associated 
drives are used as diskette track counts. Both drives, other than pos- 
sibly having different track counts (destination must be greater than or 
equal to source), have the same characteristics. The operator will be 
prompted for diskette mounts and error choices, if errors occur. Default 
parameter Y is in effect, indicating the operator does not care if the 
destination diskette previously contained data or not. The destination 
diskette will be formatted before the entire source diskette is copied to 
it, and it will receive the source diskette's name and password. Its date 
will be set to 06/01/80. If the destination diskette is to have more 
tracks than the source, they will be formated and properly accounted for 
in the directory such that the destination diskette will be ready for use. 

12. COPY 1,,NFMT This format 4 COPY is an example of an- 
other form of the simplest and most common full diskette copy. The only 
difference between this example and the one above is (1) the destination 
diskette is assumed already formatted, and (2) the current system date 
will become the destination diskette's date. 

13. COPY, 0,0, 06/ 01/80, KFMT, USD, KDN , ODN-WATCHDOG , SN-GOODDATA 

This format 5 COPY is somewhat the same as the previous example except (1) 
this is a single drive, two diskette copy, (2) a prompt will be given if 
the source diskette does not have the name specified, (3) a prompt will be 
given if the destination diskette does not have the name specified, (4) 
the destination diskette will retain its old name, (5) it will receive its 
date from the source diskette. Being a single drive, two diskette copy, 
more mount prompts will be necessary than for a two drive COPY. Also, 
because of the large number of diskette mounts that would be involved, 
this single drive COPY cannot be executed via DOS-CALL (i.e., from BASIC). 

14. COPY 0,1,,FMT > CBF This format 6 COPY is an example of one of 
the simplest and most commonly used forms of multiple file COPY. The 
destination diskette (to be mounted on drive 1) is to be formatted, and it 
receives its name and password from the source diskette (to be mounted on 
drive 0) and its date from the system date. Next, all of the source 
diskette's files, excepting BOOT/SYS and DIR/SYS, are copied to the des- 
tination diskette. 

15. COPY 0,1,, KFMT, CBF This format 6 COPY is an example of another 
of the simplest and mostly commonly used forms of multiple file COPY. The 
differences between this and example 14 are (1) the destination diskette 
is not to be formatted, (2) its name, password and date are not changed, 
and (3) any source diskette system files (other than BOOT and DIR) that 
did not already exist on the destination diskette are not copied. 
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16. COPY 1,,HFMT,CBF,USR This format 6 COPY is similar to the pre- 
vious example except that system and invisible files are not copied. 

17. COPY,0,1,,NFMT,CBF,USR,UPD This format 6 COPY is similar to the 
previous example except that the only source files copied are those marked 
as updated as well as not being either a system or an invisible file. In 
this manner, only the files changed since the last backup are backed up 
now. Remember, COPY does not clear the updated flags on the source disk- 
ette; use DOS commands PROT or ATTRIB to do this. 

18.- COPY, 2,3-60, 06/01/80, FMT,NDMW,CBF,DDSL»29,DDGA=4 

During this format 6 COPY no diskette mount prompts or error choices are 
to be displayed; the system is to assume the diskettes are already pro- 
perly mounted. The destination diskette is to be formatted with 60 
tracks. The directory will start on lump 29, and will be allocated 4 
granules. All source diskette files, except BOOT/SYS and DIR/SYS, will be 
copied to the destination diskette. 

19. COPY 2 3 06/01/80, CBF,CFWO,BFMT 

For this format 6 COPY, the destination diskette is assumed previously 
properly formatted and may contain existing files. For each source disk- 
ette file, excluding BOOT/SYS and DIR/SYS, the operator will be asked if 
the file is to be copied to the destination diskette. When all queries 
are done, the selected files are copied, excepting that system files that 
did not previously exist on the destination diskette are not copied. If 
the file already existed on the destination diskette, the file's old data 
on the destination diskette is lost. 



2.15. CREATE Pre-allocate a disk file. 

The CREATE command allows a user to create a file and optionally to write to 
the file a specified number of null records, thereby allocating the file's 
space as contiguously as possible, given the layout of the free space on the 

diskette. 

There are times when a user program expects one or more of the files it uses to 
already exist, even though the files may not have any usable data in them; 
therefore, the user must create the file prior to the program's first use. 
Also, there are times when the efficiency of a program is reduced if a file's 
diskette space is scattered all over the diskette; to avoid this, the user 
should preal locate the needed file space to reduce this scattering. 

CREATE, filespecl [ ,LRL=lnl ] [ ,REC=countl ] [ ,ASE=yn] [ ,ASC=yn] 

The CREATE DOS command creates new file filespecl or alters the state of 
existing file filespecl. 

LKL=lnl specifies the length of each record of the file, lnl must be a value 
between 1 and 256; the default value is 256. 

REC=countl specifies the number of records to be initially assigned to a file. 
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ASE»yn This parameter indicates whether, subsequent to the CREATE comdand, 
DOS may automatically allocate more diskette space to this file as necessary. 
ASE=Y allows this; ASE=N disallows this. The default is ASE=Y. 

ASOyn This parameter indicates whether the DOS close function will he al- 
lowed to automatically deallocate excess diskette space. ASOY allows this; 
ASC=N disallows it. The default is ASC=Y. 

Enough diskette space is allocated to the file to provide for countl records 
each of length lnl. lnl records of all zeroes are then written to the file, 
establishing the file EOF at the end of those records. If ASE=H is specified, 
the file is inhibited against further diskette space allocation, and if ASC=N 
the file is inhibited against automatic deallocation of excess diskette space. 

CREATE command examples: 

1. CREATE, XXX:1,LRL=30,REC=2000 File XXX is created, if it did not 
already exist, on the drive 1 diskette. The record length is 30 and 2000 
of these records, containing all 00H bytes, are written to the file. The 
EOF is left at 60000. Subsequent DOS automatic space allocation and deal- 
location for this file are allowed. 

2. CREATE, YYY:2 > 200 > ASE=N,ASC=N File YYY is created, if it did not 
already exist, on the drive 2 diskette* The record length is 256 and 200 
of these records, containing all 00H bytes, are written to the file. The 
EOF is left at 51200. Subsequent DOS automatic space allocation and deal- 
location for this file are not allowed. 

3. CREATE, ZZZ:0 File ZZZ is created, if it did not 
already exist, on the drive diskette. The record length is 256, and the 
EOF is set to 0. Subsequent DOS automatic space allocation and dealloca- 
tion for this file are allowed. 



2.16. DATE Set computer's current date. 

DATE[ ,mm/dd/yy] 

If no parameters are specified, the DATE command displays the current system 
date in mm/dd/yy format. 

If ram/dd/yy is specified, the date mm/dd/yy becomes the system date and is set 
into the real time clock, mm is the month (value 01 - 12). dd is the day 
(value 01-31). yy is the year (value 00 - 99). No check is made on the 
validity of the 3 values except to limit them to 2 decimal digits. As the 
clock reaches 24:00:00, it is reset to 00:00:00 and the date's day within month 
value is incremented. For the Model I, no adjustment is made for end of month 
or end of year. For the Hodel III, end of month and end of year adjustments 
are done by the ROM. 

At reset time, the date is set according to SYSTEM options AY or AZ. 
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DATE command examples: 

1. DATE display the system date. 

2. DATE, 08/01/81 set system date to August 1, 1981 



2.17. DEBUG enable or disable the DEBUG facility. 
DEBUGt.yn] 

DEBUG or DEBUG, Y DEBUG is enabled (but not entered). This enabling 
causes a DEBUG entry whenever a user program (such as BASIC, SCRIPS IT, PROFILE, 
EDIT, etc.) is activated. The DEBUG entry occurs after the program load is 
completed but just before its first instruction is executed. The purpose of 
this pre- execution DEBUG entry is to allow the debugging programmer to change 
the state of a program or its initialization parameters before the program 
commences execution. 

DEBUG, N The above enabling is disabled. At reset/power-on time, DEBUG 
is disabled. 

This command has no effect on the operation of '123' (the simultaneous depress- 
ing of the 1, 2 and 3 keys) to enter the DEBUG facility. 

Refer to the section 4.1 for the DEBUG facility specifications. 



2.18. DIR Display a diskette's directory information. 

DIR[;][dnl][,A][,S][,l][ ) U][,/ext][,P] 

This command displays directory information for the diskette mounted on drive 
dnl or if dnl not specified, on the drive specified by system option AN. 

The first display line contains the drive number, the diskette name, its date, 
the number of tracks, the number of free FDEs and the number of free granules. 
The values for track count and free granules are based on the current active 
PDRIVE specification for that drive and if those specifications are not proper, 
these displayed values may be in error. 

The rest of the display contains file information. 

If A is not specified, the files are displayed four to a line, giving for each 
its name and name extension, if any. 

If A is specified, DIR will list one file per display line with the display 
line containing: 

1. The file's name. 

2. The file's name extension, if any. 
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3. The file's EOF value in xxx/yyy format where xxx is the relative 
sector number within the file and yyy is the relative byte number within 
that sector. 

4. The file's logical record size (LRL) in bytes. 

5. The number of logical records (RECS) in the file including any partial 
last record. 

6. The number of granules (GRANS) allocated to the file. 

7. the number of diskette space extents (EXT) allocated where that number 
divided by four and rounded up gives the number of directory entries used 
by the file. 

8. 12 flags providing file information, defined as follows: 

1. S = system file. 

2. I = invisible file, see ATTRIB DOS command. 

3. U = file updated since last time update flags cleared by PROT 
DOS command. 

4. E - file will not be allowed to allocate more space that it 
already has. 

5. C = excess file space beyond EOF is not automatically released 
during DOS close. 

6.-9. Reserved for future definition. 

10. U = non-blank update password exists. 

11. A - non-blank access password exists. 

12. L - protection Level, see ATTRIB DOS command. 

System files are not displayed unless S is specified. 

Invisible files are not displayed unless I is specified. 

If tf is specified, only files marked as updated are displayed* Files marked as 
updated are those files changed via the standard DOS I/O write routine since 
the last time the update flags were cleared on the target diskette by the FROT 
or ATTRIB DOS command. 

If /ext is specified, only those files having the name extension ext are 
displayed, ext is to 3 characters. Example: DIR,1,/CMD will list all 
files having extension CMD such as EDTASM/CMD. 

If both U and /ext are specified, then only files satisfying both conditions 
are listed. 

When the display screen is full, DIR displays a '?' and waits for the user to 
respond ENTER to continue or BREAK to terminate the DIR function. 

If P is specified, the directory information is sent to the printer rather than 
to the display. Caution, if the printer is not ready, the system will hang 
waiting for it. 

If $ is specified, DIR will ask for the mount of the target diskette before the 
listing and will ask for the remount of the system diskette before exiting. $ 
should only be used when drive dnl = 0. There is no provision for changing the 
PDRIVE specifications internal to the DIR command. 
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The user must remember that if dnl is not specified, the default drive number 
is that specified by SYSTEM option AN which is not necessarily 0. 

DIR command examples: 

1. DIR Display the name and name extension of all non- 
system, non-invisible files on the diskette currently mounted in drive 0. 
The files will be listed four per display line. 

2. DIR 0,S,I,P Same as the previous example except that system and 
invisible files are also listed and that the listing is sent to the print- 
er instead of the display. 

3. DIR 1,/DAT,U Display the name and name extension of all of the 
current drive 1 files that are marked as updated and have name extension 

DAT. 

4. DIR 2, A All of drive 2's non-system, non-invisible files are 
displayed, one file per display line. This display will usually involve 
more than one display page with the user stepping from one page to the 
next by pressing ENTER and, if desired, terminating the DIR function by 
pressing BREAK. 

5. DIR $0 Same as example 1 except the system will a,sk for the 
mount of the target diskette on drive and when DIR is done, it will ask 
for the remount of the system diskette. 



2.19 DO Shift to keyboard input from disk. 
DO,filespecl[,sectionid] 

The DO command executes exactly the same as the DOS command CHAIN (see section 

2.9). 



2.20 DUMP Dump memory contents to disk. 

DUMP, filespecl, start-addr, end-addr [, entry-addr [,relloc-addr]] 

The DUMP command writes main memory image data from main memory to the file 
filespecl, starting with the byte at start-addr and ending with the byte at 
end-addr. 

Start-addr, end-addr, entry-addr and relloc-addr are each numeric values less 
than 65536 decimal or 10000 hex. If the value is hexadecimal it must be suf- 
fixed with a H (i.e. 8000H) ; otherwise the value is considered decimal. 
Start-addr and relloc-addr may be any value - 0FFFFH. 

This command operates in two modes, depending on the entry-addr value. If the 
entry-addr value - 65535 (0FFFFH), then an exact image of memory is dumped. 
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The start-addr value is stored in the file's first 2 bytes, and the rest of the 
file is the memory dump without any interspersed control bytes. This memory 
dump file may be displayed or printed via SUPERZAP's DMDB feature, thus allow- 
ing debugging to occur later or on another TRS-80 computer. 

If entry-addr is less than 65535 (0FFFFH) or is not specified, then the speci- 
fied area of memory is assumed to be machine executable code and is sent to the 
file in loader format so that it can be later read back in by the NEWDOS/80 
loader, either for execution or simply for load (see LOAD command). If entry- 
addr is not specified, a value of 402DH (causing return to DOS READY) is used. 
CAUTION!! If the user attempts to run or load a file whose start-addr is less 
than 5200H, DOS will be clobbered, 

relloc-addr specifies where the start-addr to end-addr range of bytes is to be 
loaded to by the LOAD command or when the program file is executed. During 
write of the object file, the value (relloc-addr) - (start-addr) is added to 
every load address placed in the object file. This value is also added to the 
entry-addr if entry-addr is within the start-addr to end-addr range. The 
actual object code is NOT altered; only the loader control information is. 

If filespecl does not specify an name extension, one is not automatically sup- 
plied as is done in TRSDOS. 

DUMP command examples: 

1. DUMP,PROGRAM/CMD:1,5200H,9ABCH,54EDH dumps the contents of memory 
from and including 5200H to and including 9ABCH to the file PROGRAM/CMD to 
exist on drive l's current diskette. The dump will be in loader format 
with entry address equal to 54EDH. Subsequently, the file may be loaded 
back into memory via the DOS command: 

LOAD, PROGRAM/CMD 

or executed via DOS command: 

PROGRAM! parameters] 

2. For this next example, assume that a user program is looping for some 
reason or has crashed, the personnel to debug the problem are not immedi- 
ately available, and it is necessary to continue using the computer for 
other purposes. If a spare formatted diskette is available with suffi- 
cient free space, and if 'DFG' can activate MINI-DOS or if the computer is 
already at DOS READY, then issue the following command: 

DUMP, TROUBLE/MEM:2,0, 65535, 65535 

which will dump 65536 bytes of main memory, including ROM, the display, 
and all of RAM to file TROUBLE/MEM. The first 2 bytes of the file will 
contain 0000H which is the dump start address; the rest of the file is the 
memory contents with no interspersed control characters. Once the dump is 
completed, the operator should set aside the dump diskette for later use 
by the debugging personnel, optionally press reset, and go on with other 
tasks. At some later time, debugging personnel can inspect the problem 
using SUPERZAP's DMDB feature to display or print the contents of file 
TROUBLE/MEM as if it were actually in memory at the current time. The 
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debugger must remember that the DOS areas 4000H - 51FFH were altered by 
DOS actions, including DUMP, after the error occured and before the dump 
actually occurred. 



2.21. ERROR Display DOS error message. 

ERROR, xx 

displays the DOS error msg associated with the error number xx where xx is an 
integer between and 63. Example: 

ERROR, 24 will display 'FILE NOT IN DIRECTORY*. 



2.22 FORMAT Format a diskette for use with the NEWDOS/80 system. 

Diskettes as they are received from the manufacturer cannot be used with 
NEWDOS/80. They must first be magnetically divided into tracks with each track 
divided into sectors of 256 bytes each. Between 15 and 30 percent of the disk- 
ette's bytes are used as format control information and are not available to 
contain user data. 

The DOS command FORMAT does this diskette formatting, setting up the tracks and 
sectors properly and building the two system files, BOOT/ SYS and DIR/SYS, re- 
quired on every diskette. When done, the diskette is ready to be used as a 
data diskette with NEWDOS/80. 

Formatting can also be done as part of the COPY command* formats 5 and 6 (see 
section 2.14). 

FORMAT, dn2[=tc2] ,name2,mm/dd/yy,password3 [ ,N] [ ,Y] [ ,NDMW] 

[ , DDND ] [ , ODN=namel ] [ , KDN ] [ , DDSL= lnl ] [ , DDGA=gc 1 ] [ , DPDN=dn4 ] 
[,PFST=tn3[,PFTOtc3]] 

FORMAT cannot be executed under MINI-DOS. 

In NEWDOS/80 version 2, a track's sectors are read immediately after the track 
is formatted and before the disk arm is stepped to the next track. Then, after 
all tracks are formatted, if SYSTEM option BM = Y, the entire diskette is read 
during the VERIFYING phase. However, if BM-N, this verifying phase is skipped. 
The user can decide whether or not the verify-at- track format is sufficient and 
set option BM accordingly. 

FORMAT does not allow the user to specify tracks to be locked out, and when an 
unverifiable sector is encountered, the associated track's lockout byte is not 
set to FF to indicate lockout. The lockout table is in the standard diskette 
directory only for compatibility with TRSDOS; NEWDOS/80 does not use it. Re- 
member, NEWDOS/80 does not account for tracks in the directory, it accounts for 
lumps which can span tracks. NEWDOS/80 operates under the philosophy, however 
wrong, that if a diskette cannot be fully formatted it should be discarded. 
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FORMAT requires all parameters be specified in the command. It does not prompt 
the user for any. 

dn2 is the number of the destination drive to be used during format. Name2 is 
the name to be assigned to the diskette unless KDN is specified to retain the 
old name, in which case name 2 must still be specified but will be ignored, 
mra/dd/yy is the date to be assigned to the diskette unless KDD is specified as 
the diskette date, in which case mm/dd/yy must still be specified but will be 
ignored. Password3 is the password to be assigned to the diskette. Password3 
must conform to the rules for passwords. 

Hull parameters may be used to invoke default values for diskette name, date 
and password, using the name NOTKAMED, the system date and the password 
PASSWORD respectively. Any combination of the 3 null values may be used but 
where used the null parameters must be delimited by commas, not spaces. See 
examples 2, 3 and 4 below. 

Since FORMAT and COPY share the same HEWDOS/80 code wherever possible, the 
specifications for the optional parameters are nearly the same as those spec- 
ified for COPY, formats 5 and 6, the main difference being that only a format 
is done rather than both a format and a copy. The reader should read the sec- 
tions for COPY, formats 5 and 6 (see section 2.14) to basically understand 
FORMAT'S optional parameters. Only the differences and two additional options 
will be given here. 

N is the default if neither it nor any of its mutually exclusive keywords are 
specified. 

If « s tc2 specified, the diskette will be formatted with tc2 number of tracks; 
otherwise the diskette will be formatted with the default number of tracks for 
that drive (see PDRIVE command). If ,c tc2 value is greater than the number of 
tracks the drive can handle, format will probably hang trying to step to the 
non-existent track. 

PFST*tn3 and PFTfrstcS optional parameters are added to allow the formatting of 
a range of tracks rather than the entire diskette. If PFST is specified, =tc2 
must not be specified, and if PFTC is specified, PFST must be specified. PFST 
means Partial Format Starting Track, and tn3 specifies the first track to for- 
mat. If PDRIVE TI flags J or K are applicable for drive dnl , DOS will add one 
to tn3. PFTC means Partial Format Track Count, and tc3 specifies the number of 
consecutive ascendingly numbered tracks to format. If PFTC is not specified 
and PFST is specified, tc3 is assumed equal to 1. After tc3 number of tracks 
have been formatted and if SYSTEM option BM = Y, the entire diskette will be 
verified. If this full diskette verify is a problem, cancel the format after 
verify starts (by pressing up-arrow); remember, each track's sectors were al- 
ready verified once immediately after the track was formatted. 

FORMAT command examples: 

1. FORMAT, 0,AAA0, 08/01/81, PSWD.Y The diskette to be mounted, at 
DOS's request, on drive will be formatted according to the PDRIVE spec- 
ifications current for that drive. DOS does not care whether the format 
diskette previously contained data or not. The diskette is named AAA0, 
dated August 1, 1981, and receives PSWD as its master password. 
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2. FORMAT, 0,,,,Y This example is identical to the previous example 
except that default values are used for the diskette name, date and pass- 
word. The diskette is named NOTNAMED, is dated with the current system 
date and is assigned PASSWORD as its password. 

3. FORMAT,!, XXX,, PSWD,N,BTDMW,DPDNi=4,DDSL=40,DDGA'=6 The diskette al- 
ready mounted on drive 1 must not contain recognizable data. It is for- 
matted according to the system diskette's PDRIVE drive 4 specifications 
(and not according to the existing drive 1 specifications). It is as- 
signed name XXX and password FSWD; its date is taken from the current 
system date. The directory starts at the beginning of lump 40 and con- 
sists of 6 granules (allows for a maximum of 222 files). Due to NDMW, DOS 
does not ask for the mount of the format diskette nor does it allow error 
retry. 

4. FORMAT, 1,,,,Y,PFST=22,PFTC=2 Suppose a power failure destroyed 
the format of tracks 22 and 23 on a diskette. Using SUPERZAP, you have 
verified that indeed SECTOR NOT FOUND error occurs on at least one sector 
on each of those tracks and, using the CDS or SCOPY functions of SUPERZAP, 
you have saved in free sectors elsewhere, either on this diskette or an- 
other, the readable sectors of those two tracks. Executing this FORMAT 
command will cause only those two tracks to be reformatted; the rest of 
the information on the diskette is not affected. When done, you can now 
move back the saved sectors and recreate the ones that were not savable. 



2.23. FORKS (Model III only) Set printer parameters. 
FORMS [ ,WIDTH*xxx] [ ,LINES=yyy] 

The FORMS command optionally changes some printer parameters and always lists 
out the printer parameters. 

WIBIH«=xxx specifies the number of characters per line where xxx must be a 
value between 9 and 255. If WIDTH is not specified, the number of characters 
per line is not changed. 

LIBES=xxx specifies the number of lines per page, and must be a value between 
1 and 254, where 254 indicates no limit on the lines per page. If LINES is not 
specified, the lines per page value is not changed. 

FORMS command examples: 

1. FORMS, WIDTH=80,LINES=60 character per line is set to 80 and lines 
per page to 60. 

2. FORMS, WIDTH>255,LINES=254 Unlimited characters per line and lines 
per page. 

3. FORMS Displays current values for characters 
per line and lines per page. 
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2.24. FREE Display number of free granules and free FDEs for each 
diskette currently mounted. 

FREE[,P] 

For each drive with a diskette mounted, FREE will display the drive number, the 
diskette name, the diskette date, the number of tracks for the diskette, the 
number of free FDEs and the number of free granules. 

If P is specified, the information will be sent to the printer instead of the 
display. 

FREE command examples: 

1 . FREE For each diskette currently mount the number of free 
granules and free directory entries is listed on the display. 

2. FREE.P Same as above except the listing is sent to the printer. 



2.25. HIMEM ' Set DOS's high memory value. 
HIMEM [, addrl] 

DOS maintains a high memory address in the two bytes at Model I location 4049H 
(Model III location 4411H). This high memory value is used by COPY, BASIC, 
EDTASM, DISASSEM and LMOFFSET as the upper limit of the memory they can use. 
User programs should also use this 2 byte HIMEM value as their upper limits. 
Caution! The loader does not use HIMEM as its upper limit during program load. 

If no parameters are specified, the HIMEM command displays in hexadecimal the 
current high memory value. 

If addrl is specified, the DOS high memory address is set to addrl which must 
be an integer between 28672 and 65535 decimal (7000H - 0FFFFH hexadecimal). 

HIMEM command examples: 

1. HIMEM Displays the current DOS high memory address. 

2. HIMEM, 49000 Set DOS's high memory value to 49000 C0BF68H). 



2.26. JKL Send the current contents of the display to the printer. 

JKL has no parameters. This command uses the same routine used by the 'JKL' 
triple key function (see section 4.5). JKL simply dumps the display contents 
to the printer. If system option AK=Y, hex codes >»= 80H (which includes the 
graphics) will be transmitted unchanged; otherwise a period will be substituted 
for them. Hex codes < 20H will be displayed as periods. Pressing BREAK during 
JKL print will terminate the JKL function. 
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JKL's main use will be either via CMD"JKL" from BASIC or via DOS-CALL from a 
user program. 



2.27. KILL delete a file. 

This command deletes a file from a diskette. The file is no longer accessible 
by normal methods and is no longer known to DOS. 

KILL,filespecl 

The file filespecl is deleted from the current diskette mounted on the speci- 
fied drive. If a drive number was not specified, then all mounted diskettes 
are searched, starting with the diskette on drive 0, and the delete is done on 
the 1st file found having the specified name and name extension. 

KILL action is as follows: 

1. If the file was allocated file space on the diskette, the space is 
released, and becomes available for subsequent assignment to other files. 
The file's data, if any, on the diskette is not altered by the KILL. This 
data, though no longer accessible, is not written over until the assoc- 
iated file space is reassigned to another file and those sectors actually 
written to. 

2. The file's FPDE and any owned FXDEs are freed by zeroing bit 4 of the 
1st byte of each and by zeroing the associated HIT sector byte for each. 
Except for that bit 4, none of the associated FPDE and FXDEs are altered 
by normal DOS operation until that FDE is reassigned to another file by 
DOS. 

If the user has inadvertently killed a file that shouldn't have been, since 
neither the associated FDE's or the diskette space used by the file is changed 
by DOS until DOS has a need to, it is possible to reconstruct the FPDE and 
FXDEs and reallocate the space. To do this, you must be extremely familiar 
with the workings of the directories; do not call Apparat as this is a major 
undertaking and not something that can be quickly taught. If you don't know 
how to do it, forget it t 

If you have more than a few files to delete at one time from a diskette, use 
the PURGE command. 

KILL command examples: 

1. KILL XXX/BAS:1 The file XXX/BAS on the diskette mounted on drive 
1 is killed. 

2. KILL YYY Starting with drive 0, mounted diskettes are 
searched until file YYY is found on one of them. That file is then 
killed. If other mounted diskettes also contain a YYY file, the other YYY 
files are not killed. 
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2.28. LC Set keyboard a - z toggle switch to the specified state. 
LC[,yn] 

IC or LC,Y sets the keyboard lower case a - z toggle switch to accept 
a - z without change. 

LC,N sets the keyboard lower case a - z toggle switch to change lower 
case a - z to upper case A - Z. 

For the Model I, the LC command has no effect unless the lower case driver is 
active (see LCDVR command). 



2.29. LCDVR (Model 1 only) Lower case driver. 
LCDVRt.xI.s]] 

In NEWDOS/80 version 1, the lower case driver that processed keyboard lower 
case alphabetics and which sent lower case displayed characters to the display 
was a separate program that executed from high memory. In version 2, the lower 
case driver is an integral part of the Model I NEWDOS/80. 

If x = Y, the lower case driver routine is activated, and if x ■ B, the routine 
is deactivated. When the lower case driver routine is active: 

1. Keyboard input a - z characters are processed according to the a - z 
toggle switch. 

2. ASCII codes 96 - 127 (60H - 7FH) are displayed as their proper charac- 
ters and are not changed to 64 - 95 (40H - 5FH) by the ROM display routine. 

The second parameter is meaningful only when x = Y, performs the same as the 
first parameter of LC command, initially setting the a - z toggle Bwitch to 
accept a - z (if s = Y) or convert a - z to A- 2 (if s = N) . 

Once the lower case driver is activated, pressing shift will switch the dri- 
ver back and forth between accepting lower case letters and converting lower 
case letters to upper case. Further, DOS command LC may be used to explicitly 
set one or the other of those states. 

To use the lower case driver, NEWDOS/80 's keyboard and display intercept 
routines must be enabled. Other routines (excluding ROUTE) that disable these 
NEWDOS/80 functions will also disable the lower case driver (one example is 
using the circular buffer in the spooler). 

If no parameters are specified, the command is assumed to be LCDVR,Y,N. 

This lower case driver operates somewhat differently than the LCDVR program 
supplied with Version 1. In Version 1, if lower case a - z was being converted 
to upper case A - Z, then upper case A - Z was also being converted to lower 
case a - z. Version 2 does not convert upper case A - Z to lower case a - z; 
instead a true capital letter lock is done. 
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LGDVR command examples 



1. LCDVR The lower case driver routine is activated and the 
lower case switch is set to convert lower case a - z to upper case A - Z, 

2. LCDVR,Y,Y The lower case driver routine is activated, and the 
lower case switch is set to accept lower case a - 2 without modification, 

3. LCDVR,N The lower case driver routine is deactivated. 



2.30. LIB Display NEWDOS/80 library commands. 

LIB requires no parameters. It displays the library commands of NEWDOS/80. 
Commands FORMAT, COPY and APPEND execute in memory 5200H and up, and, along 
with CHAIN, cannot be executed in MINI-DOS. The other commands execute from 
the DOS overlay area, 4D00H-51FFH, and, except for CHAIN, can be executed under 
MINI-DOS. 



2.31. LIST List a text file on the display. 

LIST, filespecl [ , start-line [ , line-count ] ] 

This command sends the contents of file filespecl to the display. Though file 
filespecl need not be a text file, if it is not, the resulting display will not 
be very meaningful. Examples of text files are BASIC programs saved with the A 
option, BASIC files written using PRINT, assembler, FORTRAN and COBOL source 
text files, SCRIPSIT files saved with the A option and Electric Pencil files. 
To list a non-text file, use SUPERZAP. 

No check is made on the character representations except to modulate characters 
whose hexadecimal values are between 80H and FFH into the range 00H to 7FH and 
to replace with a period all characters whose hexadecimal value is less than 
20H or greater than the high ASCII character value specified by the SYSTEM op- 
tion AX. 

If start-line (decimal value 1 - 65535) is specified, listing will start with 
that line where a line is considered to end with the ENTER or EOL character 
0DH. 

If line-count is specified, then the number of lines displayed is limited to 
either line-count or the number of lines in the file from the start point, 
whichever is less. If line-count is specified, start-line must also be speci- 
fied. 

Pressing right arrow will cause a display pause when hex char 0DH is encount- 
ered or after 256 bytes have been displayed, whichever comee first. Pressing 
ENTER will continue the displaying. Pressing up-arrow will terminate LIST. 

Aside from just listing a file, LIST is useful where text files maintain a 
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date/ time stamp near the beginning. If the user has multiple copies of a text 
file, it may be necessary to look at the file beginning to determine which copy 
is the most recent. 

LIST command examples: 

1. LIST.BASEPROG/BAS displays the entire contents of file 

BASEPROG/BAS. 

2. LIST,XXX,1,6 displays the first 6 lines of file XXX. 

3. LIST, YYY:1, 200 displays the contents of file YYY from the 

200th line to the end of the file. 



2.32. LOAD Load a Z-80 machine language file into RAM. 

LOAD,filespecl 

This command loads the Z-80 machine language file filespecl into RAM, and 
stores its entry address into the two bytes at 4403H (17411 decimal). The file 
must be in proper loader format, such as created by DUMP or EDTASM. The load 
proceeds using control data from the file. If the file loads over any part of 
the resident DOS (4000H - 4CFFH) or its overlay area (4D00H - 51FFH), serious 
and maybe file damaging trouble will occur; with luck, the system will hang. 

LOAD is used when a program or data is to be loaded into RAM for later use by 
other programs. An example is loading programs which will be invoked via 
BASIC'S USR function. Remember, the entry address is stored in the two bytes 
at 4403H (17411 decimal); this is not done in TRSDOS. 

LOAD command examples : 

1. L0AD,0VERLAY/0BJ:1 The object code module OVERLAY/OBJ is loaded 
into main memory from the diskette mounted on drive 1. The load control 
information within file OVERLAY/OBJ determines what is to be loaded and 
where in main memory it is to be loaded. 

2. Suppose that BASIC does not use all of high memory and that a BASIC 
program wishes to load the program USR3PGM/0BJ into high memory and later 
execute it as the BASIC USR3 function. Executing the BASIC statements: 

CMD"L0AD,USR3PGM/0BJ" 

DEFUSR3 = (PEEK(17411) + 256 * PEEK(17412) - 65536 

will set this up. 



2.33. MDBORT Terminate MINI-DOS and go to DOS READY. 

MDBORT has no parameters. It should only be executed when NEWDOS/80 is in 
MINI-DOS state. MINI-DOS state is terminated, the pre-MINI-DOS state purged 
and the system goes to DOS READY. 
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The purpose of MDBORT is to provide for the situation where the operator does 
not want to continue the main program which was interrupted by the simultaneous 
depression of the D, F and G keys (which invoked MINI-DOS). 



2.34. MDCOPY Copy a file while under MIHI-DOS. 

MDC0PY,filespecl[,T0],filespec2 

The regular COPY command cannot be executed under MINI-DOS. MDCOPY gives the 
user a restricted and quite slow form of file copy which does execute under 
MINI-DOS. 

MDCOPY copies the contents of file filespecl to the new or existing file file- 
spec2. File filespecl is not altered, and the previous contents of file file- 
spec2, if any, are lost. Filespec2 may not be foreshortened as is allowed for 
COPY. 

MDCOPY command example: 

MDCOPY XXX/DAT:0 YYY/DAT:1 

The contents of file XXX/DAT on the diskette currently mounted on drive 
is copied as file YYY/DAT onto the diskette currently mounted on drive 1. 



2.35. MDRET Exit from MINI-DOS and return to main program. 

MDRET has no parameters. The system exits MINI-DOS state and continues the 
main program at the point where it was interrupted by the invocation of MINI- 
DOS (simultaneous depression of the D, F and G keys). If the cursor was dis- 
played before 'DFG', it will be redisplayed. If the 'DFG* interruption occur- 
ed while the key input buffer contained a partial input record, that partial 
record is still there even though it is no longer displayed. The user should 
continue keying exactly where he/she left off. 

If the invocation of MINI-DOS occured during the timer interrupt rather than 
the key intercept, one or more of D, F or G may appear as spurious input keys 
after MDRET is executed. The user should backspace over them. The user and 
DOS have no control over these spurious input chars; therefore DFG should not 
be pressed when a program is in text overwrite mode, such as SCRIPSIT or 
Electric Pencil; instead go into command mode where the spurious characters can 
be backspaced over without damage to the text. 
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2.36. PAUSE Display message and pause waiting on ENTER. 
PAUSE, msg 

The message msg is not redisplayed if the PAUSE command itself was displayed. 
If the PAUSE command was not displayed, as occurs if it is executed under 
DOS-CALL, the message msg is displayed. In any event, the message PRESS 
"ENTER" WHEN READY TO CONTINUE is displayed on the next line. DOS then waits 
for the user to press the ENTER key. The PAUSE command is one of the four 
ways of causing a pause in chaining, and can also be used when a series of 
commands in main memory are being executed by a Beries of DOS-CALLs. 

PAUSE command example: 

PAUSE, MOUNT DISKETTE LABELED "PRIMARY" ON DRIVE 1. 

This message will appear on the display and will be followed on the next 
display line by the message PRESS "ENTER" WHEN READY TO CONTINUE. DOS 
waits for the user to press ENTER which presumably he/she will do after 
the proper diskette has been mounted in drive 1. DOS doesn't check to see 
if the user has done what was requested; all DOS does is wait for the 
ENTER. 



2.37. PDRIVE Assign default attributes to a physical drive. 

PDRIVE[ ,passwordl : ]dnl , [dn2[=dn3] ] [ ,TI=typel] [ ,TD=type2] [ ,TOtcl] 
[ ,SPT=scl ] [ ,TSR=rcl ] [ ,GPL=gc2] [ ,DDSL=lnl ] [ ,DDGA=gcl ] [ ,A] 

NEWDOS/80 has limited capabilities for operating with a mixture of 5 inch disk 
drives and to a lesser extent 8 inch disk drives. PDRIVE is the command method 
used to inform NEWDOS/80 of a particular physical drive's characteristics. 

Each PDRIVE command lists the resulting specifications for 10 drives even 
though the actual number of drives eligible for I/O is limited by the SYSTEM 
option AL and in no case exceeds 4. Those drives within the range of SYSTEM 
option AL are flagged on the PDRIVE display by an asterisk suffixed to the 
drive number. The specifications for the 10 drives is maintained on the system 
diskette mounted on drive dnl . For efficiency reasons, DOS normally uses drive 
specifications from a table it has in main memory. This main memory PDRIVE 
table contains specifications for 1 to 4 drives, depending upon the SYSTEM op- 
tion AL value, and is automatically reloaded from the drive diskette at power 
on and reset if and only if the specifications for all 10 drives are error free 
(otherwise the reset hangs). This table is also immediately reloaded by a 
PDRIVE command specifying the A parameter (see below). 

Drive dnl is the drive containing the system diskette whose control information 
(in the 3rd sector) is being updated. Drive dn2 indicates which physical drive 
of the 10 represented in the control information sector on drive dnl is having 
its control information updated. 

For example, if the PDRIVE command is PDRIVE, 1 ,4, TC=80 then the diskette 
on drive 1 is read to obtain the PDRIVE control information and is updated 

2-33 DOS LIBRARY COMMANDS 



PDKIVE 



to contain the new drive 4 specification. Drive l's PDRIVE control infor- 
mation contains the specifications for ten drives, dn2 values through 9, 
and it is the fifth drive's information (for dn2 = 4) that is changed. 
The specifications for the other nine drives are not changed. 

If passwords are enabled, then passwordl must be specified and be the master 
password for the diskette on drive dnl . Otherwise passwordl may be left out of 
the command. 

Control data is changed only for the parameters specified; parameters not 
specified are not changed. If any errors are displayed, the dnl diskette must 
NOT be used as the system diskette during a reset/power-on until the errors are 
corrected. 

PDRIVE, dnl will list the 10 PDRIVE specifications contained in the control 
data on the system diskette mounted on drive dnl. 

dn2 must be specified if any other optional parameters except A are 
specified. If dn2 is specified, it must be the 1st parameter following dnl. 

dn2=dn3 causes drive dn2 to assume the PDRIVE specifications of drive dn3. 
This is done before any other optional parameters are interpreted. 

TI=typel specifies the type of disk drive interface, typel consists of one 
or more alphabetic letter flags chosen from the list below. For the Model I, 
one and only one of flags A, B, C or E must be chosen. For the Model III, one 
and only one of flags A or D must be chosen. The other flags are optional 
depending upon the interface. Certain flags are inter-drive mutually exclusive 
meaning that for a given drive dnl , if one dn2 drive specifies a flag that is 
interdrive mutually exclusive with another flag, then another dn2 drive may not 
specify the excluded flag. For now, flags B, C and E are interdrive mutually 
exclusive for the Model I. 

Flag A means the standard disk interface is to be used for diskette I/O 
for this drive. For the Model I this interface supports drive types A and 
C. For the Model III this interface supports drive types A, C, E and G. 

Flag B (Model I only) means that an OMIKRON mapper type interface is 
installed and is to be used for I/O for this drive. This interface sup- 
ports drive types A, B, C and D. 

Flag C (Model I only) means that a PERCOM doubler type interface is in- 
stalled and is to be used for I/O for this drive* This interface supports 
drive types A, C, E and G. 

Flag D (Model III only) means that an Apparat disk controller type in- 
terface is installed and is to be used for I/O for this drive. This in- 
terface supports drive types A through H (drive types F and H require a 
Model III speed up modification). 

Flag K (Model I only) means that an LNW type interface is installed and 
is to be used for I/O for this drive. This interface supports drive types 
A through H. 
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Flag H means head settle delay is to be done whenever DOS changes from 
another drive to this drive. For Model I and Model III 5 inch drives, the 
heads for all 5 inch drives are loaded when the motors go on, and this 
extra time delay is NOT needed. Flag H is needed for 8" drives. 

Flag I means the lowest numbered sector on each track is sector 1. This 
is the normal state for Model III TRSDOS diskettes. If flag I is not 
specified, the lowest numbered sector on each track is assumed to be 0, 
which is the state for the Model I and for NEWDOS/80 on the Model III. 

Flag J means the track numbers start from 1. If flag J is not speci- 
fied, track numbers are assumed to start from 0, which is the standard 
state for the Model I and the Model III. 

Flag K means track is formatted (or is to be formatted) in density 
opposite to that of the diskette's other tracks. This makes track un- 
available for normal I/O. Flag J is implicitly set by flag K. The pur- 
pose of formatting track t in opposite density is to allow a double den- 
sity (Model I) or single density (Model III) SYSTEM diskette to be booted 
up. The Model I ROM must he able to read the boot sector in single den- 
sity, and the Model III ROM must be able to read the boot sector in double 
density. Setting flag K causes FORMAT and COPY with format to format 
track in the opposite density and to store the required boot sector onto 
that track for the ROMs to use. With flag K set, normal DOS I/O to track 
actually goes to track 1, 1 to 2, etc. Flag K must be specified for a 
drive that is to read a double density diskette created by the PERCOM type 
doubler interface under NEWDOS/80 version 1 or any other DOS except 
NEWDOS/80 version 2 or higher. For NEWDOS/80 version 2 Model I, double 
density data diskettes do not have to reserve track for opposite density 
if those diskettes will never be used on a drive whose PDRIVE specifies 
double density. Flag K must NOT be specified for standard Model III 
diskettes, unless for some reason the user wants a single density system 
diskette on the Model III or is making a double density diskette to be 
read on the Model I that does not have NEWDOS/80 version 2. When flag K 
is specified, then TC must specify one less track than would be specified 
if flag were not specified. Further, due to the differing sequence in 
which consecutive sectors are stored on the diskettes, double sided, 
double density diskettes created under the patched NEWDOS/80 version 1 are 
not readable under NEWDOS/80 version 2. To transfer files on those disk- 
ettes to Version 2, they must first be moved (using Version 1) to either 
single sided (either density) or double sided, single density diskettes. 

Flag L means two step pulses between tracks. This allows a 35 or 40 
track diskette to be read on an 80 track drive. Writing can also be done 
in this manner, but the 35 or 40 track drives have trouble reading some of 
the sectors so writing is not recommended. 

Flag M means the diskettes are standard TRSDOS Model III diskettes. 
Flag M implies flag I. The COPY DOS command is the only function within 
NEWDOS/80 that will honor or even notice a TRSDOS Model III diskette as 
distinct from a NEWDOS/80 diskette, and even this will not occur unless 
flag M is set. 

Flags F through G and N through Z are reserved for future definition. 
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ID is the Type of Drive specification. The definitions are: 



1. 


TD=A 


5 


inch, 


single 


density. 


single 


sided drive. 


2. 


TD=B 


8 


inch, 


single 


density, 


single 


sided drive* 


3. 


TD=C 


5 


inch, 


single 


density, 


double 


sided drive* 


4. 


TD=D 


8 


inch, 


single 


density, 


double 


sided drive. 


5. 


TD=E 


5 


inch, 


double 


density, 


single 


sided drive. 


6. 


TD-F 


8 


inch, 


double 


density, 


single 


sided drive. 


7. 


TD-G 


5 


inch, 


double 


density, 


double 


sided drive. 


8. 


TD=H 


8 


inch, 


double 


density, 


double 


sided drive. 



If a CPU speed up module is installed in the computer that reverts to 
normal CPU during disk I/O, this reversion must not slow the CPU speed to 
less than the original rated CPU speed for that model. NEWDOS/80's disk 
I/O loops, especially for the Model 1 for drive types B, D, E and G, can- 
not tolerate any reduced CPU speed below the original speed. In limited 
testing and with SYSTEM option BJ properly set, NEWDOS/80 Version 2 has 
run disk I/O successfully without the need to turn off the CPU speed; 
however, Apparat does not guarantee such performance. 

TD=F and TD=H require a CPU speed up module installed in the computer 
which at least doubles the CPU's speed during disk I/O. 

For drive types C, D, G and H, the current NEWDOS/80 interfaces (TI flags 
A, B, C, D or E) consider a double sided diskette as a single volume 
(i.e., only one directory) with each track having its lower numbered sec- 
tors on the first side and the higher numbered sectors on the second side. 
Pin 32 is used to select the 2nd side (special cables required), and any 
drive on the cable that shunts pin 32 over as a drive 3 select must have 
that shunt wire cut to prevent that drive from being selected when another 
drive's 2nd side is being selected. Double sided, double density 40 and 
80 track drives have been used on the Models I and III under HEWDOS/80 
Version 2. 

One of the reasons Apparat never supported double density in Version I was 
that most drives did not work reliably in double density. Whether this 
was the fault of the drives, the diskettes, the data separator or the 
controller was never really ascertained. Over the last nine months things 
have improved somewhat, but double density is still not as reliable as 
single density and probably never will be. Apparat was informed that the 
two byte pattern 6DB6 is a much better "worst case" double density pattern 
than the E5's used in single density, and indeed the 6DB6 pattern is such. 
In fact, it is such a good "worst case" condition that a good percentage 
of certified double sided, double density diskettes will fail format. To 
many users, this will prove intolerable and they will want to apply the 
ZAP that goes back to the E5 pattern, if it is not already applied. How- 
ever, using the E5 pattern in double density means that the user will in- 
crease the probability that a diskette that formats successfully will at 
some future time fail. 

TC=tcl specifies the number of tracks on the disk, excluding track if TI 

flag K is set. If flag K is not set, TC=35 for a 35 track drive, TC-40 for a 

40 track, etc. If flag K is set, then TC=34 for a 35 track drive, TC=39 for a 
40 track, etc. 



m 
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SPT=scl specifies the number of sectors per track. For double sided, single 
volume diskettes (TD - C, D, G or H) , scl must be twice what it would be if 
single sided diskettes, scl may be any value from 1 to the maximum number of 
256 bytes sectors the track can physically hold. For each of the above speci- 
fied drive types, the maximum number of sectors per track is: A=10, B=17, 
C=20, D=34, B-18, F=26, G=36 and H=52. 

TSR=rcl specifies the track stepping pulse time code the controller uses for 
this drive, rcl is a value from to 3 and becomes part of the SEEK, STEP and 
RESTORE commands sent to the controller. For the Model I and III standard 
controllers, TSR=0 gives 5 ms stepping, TSR=1 gives 10ms stepping, TSR=2 gives 
20ms stepping and TSR-3 gives 40ms stepping. TSR=3 was the original standard 
for the Model I, with some users using TSR=2 or TSR=1 for certain drives. The 
Model III appears to use TSR=0 as standard. If you are having drive trouble, 
the safest setting is TSR=3 (fastest stepping rate for the Model I is 12ms). 

GM>gc2 specifies the number of granules per lump where gc2 is a value between 
2 and 8. In TRSDOS for the Model I and III and the older versions of NEWDOS, 
disk space allocation was done via granules (5 sectors per granule on the Model 
I and 3 per granule on the Model III) and tracks (2 granules per track on the 
Model 1 and 6 granules per track on the Model III). In NEWDOS/80 version 2, 
for both the Models I and III, there are still 5 sectors per granule, and 2 to 
8 granules per lump (not track). Wherever a track number appeared in the 
directory (in the GAT sector and in the FDE two byte extent elements), it has 
been replaced with a lump number. Doing so allows a granule to start in one 
track and end in another and allows double density and 8 inch diskettes to 
maximize the number of sectors per track while keeping the same directory 
format. GPL=2 maintains compatibility with the old 35 track single density 
diskettes, as the directories will be exactly the same and transferable back 
and forth between the Model I TRSDOS and NEWDOS versions before NEWDOS/80 
version 2. However, by going to GFL=8 the directory can now accommodate 192 x 
8x5= 7680 sectors or 1,966,000 bytes. 

DDSL=lnl is the logical equivalent of and replacement for the DDST parameter 
used in NEWDOS/80 version 1. Inl specifies the number of the lump at whose 
first sector is to contain the directory's 1st sector. This value is stored in 
the boot sector 3rd byte during diskette format and is used when necessary to 
find the directory. It is also used during diskette format to determine where 
to put the directory. In the older systems, the 3rd byte of the boot sector 
contained the track number in whose 1st sector the directory started. Since 
tracks are not used in space allocation and control in NEWDOS/80 version 2, the 
3rd byte of the boot now contains the number of the lump in whose 1st sector 
the directory starts. To determine the relative sector number of the direc- 
tory's 1st sector (the GAT sector), access the boot sector's 3rd byte and mul- 
tiply that value by 5 times GPL. DDSL=17 maintains compatibility with the 
standard 35 track, single sided, single density diskettes. DDSL should be set 
to the value used for the DDST parameter in NEWDOS/80 version 1. 

DDGA=gcl specifies the default number of granules to be allocated to the 
directory when it is created during format, where gel is a value between 2 and 
6. DDGA=2 should be specified for standard 35 track, single density, single 
sided compatibility, gel > 2 allows the user to have more than 62 files on a 
data diskette with the maximum being 222 files. 

A specifies that if and only if no errors wera found during the checking of 
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the specifications for all the drives, then the specifications for SYSTEM 
option AL number of drives is loaded into the main memory PDRIVE table to ^^d~ 

immediately become the controlling data for those drives; this eliminates the WW* 
need for a reset. If parameter A is specified, dnl must = 0. ^^^ 

PDRIVE is executeable under MINI-DOS. 

PDRIVE command examples: 

1 . PDRIVE, dnl ,dn2,TI=A,TD=A,TC»35,SPT=10,TSR=3,GPL=2,DDSI,-17,DDGA=2 

is the PDRIVE specification for a standard 5 inch, 35 track, single den- 
sity, single sided diskette used for communication in the Model I world. 
This specification can also be used on the Model III to read the diskette 
providing the directory address marks are correct (see SYSTEM option AN). 

2. PDRIVE, dnl ,dn2,TI=A^TD=E > TC=40,SPT=18,TSR^iGPL-2,DDSL=17,DDGA=2 

is the Model III specification (Model I, use TI-C) for a standard 5 inch, 
40 track, double density, single sided diskette used for communication 
through out the NEWDOS/80 Model III world. Using this specification, this 
diskette can also be read on the Model I in a drive other than if a dou- 
ble density modification is installed in the expansion interface. 

3 . PDRIVE, dnl , dn2 , TI=AM, TD=E , TC=40 , SPT=1 8 , TS R=3 , GPL=6 ,DDSL=1 7 , DDGA=2 

is the Model III specification (Model I, use TI=CM or EM) for reading or 
writing to a TRSDOS Model III standard 5 inch, double density, single 
sided diskette. A 40 track, double density, single sided 5 inch diskette 
is the only type TRSDOS Model III diskette that NEWDOS/80 can handle. 
GPL=6 is mandatory. Since a TRSDOS Model III diskette cannot be formatted 
by NEWDOS/80, DDSL and DDGA are meaningless. In NEWDOS/80 (double density 
mod must be installed for Model I), only the COPY DOS command can he used 
with TRSDOS Model III diskettes excepting that diskette sectors can be 
read/written via SUPERZAP by using the DD, DM, DTS, VDS, CDS, CDD, etc. 
functions that do not refer to files (i.e., don't use DFS) . 

4. PDRIVE, dnl, dn2,TI=A,TD=C,TC=80,SPT=20,TSR=2,GPL=8,DDSL-20,DDGA=6 
is the specification for a 5 inch, 80 track, single density, double sided, 
single volume diskette with 20ms stepping, 8 granules per lump, with the 
directory positioned at the diskette halfway point and maximum size direc- 
tory. For the Model III, the single density drive restriction applies. 

5. PDRIVE, dnl, dn2,TI=A,TD=G,TC=80,SPT=36,TSR=2,GPL=8,DDSL=35,DDGA=6 
is the Model III specification (Model I, use TI=C or E) for a 5 inch, 80 
track, double density, double sided, single volume diskette to use 20ms 
stepping, 8 granules per lump, maximum size directory positioned at the 
diskette halfway point. For the Model I, the double density drive 
restriction applies* 

6. PDRIVE, dnl, dn2,TI=CK,TD=E,TC-39,SPT=18,TSR=3,GPL=2,DDSL-17,DDGA=2 
is the Model I specification (Model III, use TI=AK) for 5 inch, 40 track, 
double density, single sided diskette that has track formatted in single 
density, hence only 39 tracks available for regular use. This specifica- 
tion will handle double density diskettes formated by TRSDOS and NEWDOS/80 
version 1 running under the PERCOM doubler. This specification will also 
be used when generating a double density diskette to be the system disk- 
ette in drive for the Model I. For LNW Model I interface, use TI-EK. 
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7. PDRIVE,dnl > dn2,TI=CK,TD=G,TC=79,SPT=36,TSR<=3,GPL=8,DDSL«35,DDGA=6 
is the Model I specification (Model III, use TI=AK) for a 5 inch, 80 
track, double density, double sided, single volume diskette that has track 
formatted single density. For the LHW Model 1 interface, use TI=EK. 

Warning Ell Double sided, double density diskettes used on the patched 
NEWDOS/80, version 1 are not usable on Version 2 (see TI flag K 
discussion). 

8 . PDRIVS , dnl , dn2 , TI=AL , TD=A, TC=3 5 , SPT=1 , TSR=3 , GPL=2 , DDSL=1 7 , DDGA=2 

is the specification for a 5 inch, 35 track, single sided, single density 
diskette that is to be read on an 80 track drive. The 80 track drives 
step only half as far as the 35 and 40s for each data track; setting flag 
L causes 2 steps to be taken for each data track stepped. 

9 . PDRIVE, dnl , dn2 , TI=BH , TD=B , T07 7 , SPT=1 7 , TSR=3 ,GPL=3 , DDSL=1 7 , DDGA=6 

is the Model I specification for an 8 inch, 77 track, single sided, single 
density diskette. Note, NEWDOS/80 version 1 used SPT=15 and an implied 
GPL=3, and to read those diskettes, SPT=15 and GPL=3 must be used. It is 
recommended that a COPY be done to convert those diskettes to SPT=17, thus 
gaining 12% more diskette space. Flag H causes head load settle delay to 
be used, required for most 8 inch drives. 

10. PDRIVE,dnl,dn2,TI=BH,TD=D,TC=77,SPT=34,TSR=3,GPL=8,DDSL«=17,DDGA=6 
is the Model I specification for an 8 inch, 77 track, single density, 
double sided, single volume diskette with head load settle delay required. 

11. PDRIVE,dnl,dn2=dn3 is the specification to cause drive dn2 to 
receive as its specifications those of drive dn3. 

12. PDRIVE, dnl, dn2=dn3,TC=40,TSR=2 is the specification to cause drive 
dn2 to receive as its specifications those of drive dn3 and then to apply 
new values for TC and TSR. 

13. PDRIVE,0,A causes the PDRIVE data for SYSTEM option AL number of 
drives to be loaded into the main memory PDRIVE table if and only if the 
full display of the specifications shows no error. 

14. PDRIVE, 0,dn2=dn3, A changes drive 0's specifications for dn2 to be 
those of dn3, and then performs as in the above example. 



2.38. PRINT List a text file on the printer. 

PRINT,filespecl[ , start- line [, line-count] ] 

PRINT executes identical to LIST, excepting the listing goes to the printer 
instead of the display. Refer to DOS command LIST for specifications and 
examples. 
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2*39. PHOT Alter some diskette control data. 

PROT, [passwordl : ]dnl [ ,NAME=namel ] [ ,DATE=mm/dd/yy] [ ,RUF] 
[ ,PW=pasaword2] [ ,LOCK] [ ,DHLOCK] 

At least one optional parameter must be specified. The target diskette is 
mounted on drive dnl. If passwords are enabled, passwordl must be specified 
and must equal the diskette's master password. 

HAMBF=namel The diskette is given the name namel. 

MT»arani/dd/yy The diskette is given the date ram/dd/yy. 

MJF Reset Udated Flags. This option turns off the updated flags for all 
files on the diskette. If a user hacks up only those files having the updated 
flag on (see UPD option of COPY) off, executing PROT with the RUF option after 
the copying is completed turns off the updated flags so the files will not be 
eligible for a subsequent backup until the file is subsequently updated. 
Simply writing or rewriting one sector of the file, whether or not anything was 
actu- ally changed, causes DOS to turn on a file's updated flag. 

PlNpassword2 Password2 must conform to the rules for passwords, with null 
set as all blanks. The diskette receives password2 as its password. 

I4)GK All files of the diskette, except system and invisible files, are 
given the diskette master password as both their access and update passwords. 
If password2 specified, it is used. This feature used to be the only way a 
user, in a password enabled system, could get to a file whose password(s) he/ 
she had forgotten, if the user did know the diskette master password. It has 
the unfortunate drawback in that it changes the passwords for all, except sys- 
tem and invisible, files on the diskette; thus causing the user to reassign 
passwords to all the others as well as to the file whose passwords he/she for- 
got. An easier way is available if the user knows the password of at least one 
HEWDOS/80 system diskette or better still, has a NEWDOS/80 system diskette with 
passwords disabled (system option AA = N), With passwords disabled, the user 
can use ATTRIB to directly reassign new passwords to the file whose passwords 
are forgotten without having to affect other user files on the diskette. Then 
passwords can be reenabled. 

WSUMX. The access and update passwords of all of the diskette's files, 

except system and invisible files, are set to all blanks, meaning no passwords 
for those files. 

PROT command examples : 

1. PROT, 2, RUF The updated flag is cleared for each file on the 
diskette currently mounted on drive 2. 

2. FROT,OLDPSWD:1,NAME=AAB3,DATE=07/15/81,PW=HEWPSWD 

In this example, passwords are enabled; therefore the diskette's master 
password OLDPSWD was required. The diskette control information for the 
diskette mounted on drive 1 is changed such that its name is AAB3 , its 
date is July 15, 1981 and its new master password is NEWPSWD. 



DOS LIBRARY COMMANDS 2-40 



# 



FtfBGE - K 

2.40. PUBCE Selectively kill files from a diskette. 

PURGE, [passwordl : ldnl [ ,/ext J [ ,USR] 

The diskette mounted on drive dnl is used for this command. If passwords are 
enabled, passwordl must be specified and must be equal to the diskette's master 
password. 

For each file, except BOOT/SYS and DIR/SYS, on the diskette, DOS asks the 
operator if the file is to be killed. If the file is to be killed, respond Y; 
the file will be immediately killed, as if a KILL command has been issued. If 
the file is NOT to be killed, respond N. Respond Q if you wish to quit the 
PURGE function. 

/ext If this option is specified, the purge queries are limited to only 
those files having name extension ext where ext is to 3 characters. 

0SR If this option is specified, system and invisible files are not in- 
cluded in the PURGE function. 

PURGE command examples: 

1. PURGE, 1 For each file, except BOOT/SYS and DIR/SYS, on the 
diskette currently mounted on drive 1, DOS asks if the file is to be 
killed. If the response is Y, the file is killed. 

2. PURGE, 0,/ DAT For each file on the diskette currently mounted on 
drive that has name extension DAT, DOS asks if the file is to be killed 
and does so if the response is Y. 

3. PURGE, 0,USR For each non-system, non-invisible file on the 
diskette currently mounted on drive 0, DOS asks if the file is to be 
killed and does so if the response is Y. 



2.41. R Repeat the previous DOS command. 

This command causes the re-execution of the previous DOS command, excluding the 
command R. Example: 

DIR 1 followed by: 

R 

will execute the same as if the two DOS commands had been: 

DIR 1 
DIR 1 



The R command can not be executed from BASIC via CMD"doscmd 1 ' as that function 
requires that the command, excluding ENTER, must be 2 or more characters long. 
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The R command has no parameters and must be keyed exactly as R followed by 
ENTER. If more than 2 characters are keyed into the buffer and then backspaced 
so that DOS only sees the R and the ENTER, the previous DOS command that was 
residing in the command buffer will still have been altered and the R command 
will either fail or in rare circumstances, execute something different than 
what the operator expected. 

If the previous DOS command is no longer intact in the DOS command buffer, the 
results of the R command are unpredictable. 

If SYSTEM option BE = N, the R command does not execute the previous DOS com- 
mand but instead simply returns to DOS READY. 



2.42. REHAME Rename a file. 
RENAME , filespecl [, TO], filespec2 

The file filespecl is renamed to filespec2, where filespec2 consists of only a 
name and optionally a name extension. If filespecl does not specify a drive 
number, then all mounted diskettes are searched, and the first file encountered 
matching filespecl 's name and name extension is renamed. RENAME change only 
the file's name and name extension; nothing else is changed. 

RENAME command example: 

1. RENAME XXX/DAT:1 YYY/OBJ The file XXX/DAT on the diskette 
currently mounted on drive 1 has its name changed to YYY and its extension 
changed to OBJ. 



2.43. ROUTE 

1 . ROUTE 

2. ROUTE, CLEAR 

3 . ROUTE, devl [ ,dev2] [ ,dev3 ] . . . . 

The purpose of the ROUTE command is to allow some flexibility from where the 
keyboard and/ or RS-232 input ie received and to where display, printer and 
RS-232 output is sent. 

At the conclusion of a ROUTE command, any existing routes are displayed; if 
none, nothing is displayed. ROUTE with no parameters does nothing except dis- 
play the existing routes. 

ROUTE, CLEAR clears all routes. 

devl specifies the device being routed. dev2, dev3 , etc. specify the deviceCs) 
being routed to (the routed-to devices) when devl is an output device or routed 
from (the routed-from devices) when devl is an input device. For the Model I, 
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the device codes are KB for the keyboard, DO for the display, PR for the 
printer and NL for null (meaning nothing is transferred). For the Model III, 
RI for the RS-232 input and RO for the RS-232 output are added to the above 3 
codes. An input device (KB or RI) may not be routed to an output device (DO, 
PR or RO) , and an output device may not be routed to an input device. 

Whenever devl is specified, ROUTE initially clears any previously existing 
routes for that device and then establishes the routes specified by dev2, dev3, 
etc. , if any. 

Any of the devices dev2, dev3 , etc. may also be of the form MM«addr where 
addr specifies the main memory location of a user routine to which devl is to 
be routed. The first 12 bytes of the routine are reserved for use by DOS and 
must not be altered by the user. Upon routing, the user routine is entered via 
a CALL at the 13th byte, and it is the user's responsibility to save and re- 
store all registers, except AF, used by the routine and routines it calls. If 
devl is an input device, the routine returns the new byte in register A with a 
zero indicating there is no new input byte from that routine. If devl is an 
output device, upon entry to the routine, register C contains the byte being 
outputted. 

If devl is an output device,, the output byte is sent to all routed-to devices 
in the order given in the ROUTE command. 

If devl is an input device, each routed-from device is queried in the order 
given in the ROUTE command. If that device supplies a non-zero byte, the 
queries stop and the byte is used as the input byte for the devl . If no 
routed-from device has an input byte, a zero is considered devl's current byte. 

The. maximum number of routeB-to and routes-from, excluding MM=addr types, in 
existence at one time is four for the Model I and six for the Model III. 

WARNING!!! No editing of input or output characters is done during routing. 
This may cause problems (i.e. , display control characters causing the printers 
to do unpredictable things). 

ROUTE command examples : 

1. ROUTE, PR, DO Printer output does not go to the printer but 
instead goes to the display. 

2. ROUTE, DO, DO, PR Display output goes to both the display and the 
printer. 

3. ROUTE, PR, DO,PR Printer output goes to both the display and the 
printer. If the routes of both example 2 and 3 are active, the routing is 
equivalent to the Model III TRSDOS function DUAL. 

4. ROUTE, KB, RI (Model III only) Keyboard input characters come 
from the RS-232 input device and not from the keyboard. 

5. ROUTE, DO, RD (Model III only) Display output is sent to the 
RS-232 output device and not to the display. 

6. ROUTE, PR, MM=0FE80H Printer output is sent to the routine at main 
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memory location 0FE80H (the routine's actual entry point is 0FE8CH). 

7. ROUTE,KB,KB,MM-0F800H Keyboard input comes from either the 
keyboard or the routine at main memory location 0F800E. Input from the 
keyboard has precedence. 

8. ROUTE, PR, NL Printer output is discarded. 

9. ROUTE, PR All routing for the printer is dissolved. Printer 
output goes to the printer. 

10. ROUTE, CLEAR All routes are dissolved, and all devices are 
returned to their normal paths. 



2.44. SETOOK (Model III only) Set RS-232 interface parameters. 

SETCOM [ ,OFF][ ,WORD=wl] [ ,BAUD=br] [ ,STOP=sb] [ ,PARITY=pp] [ ,WAIT] [ ,NOWAIT] 

The SETCOM command optionally changes the state of the RS-232 interface and 
always displays the state. For RS-232 discussion, see chapter 8 of the Model 
III Operation and BASIC Language Reference Manual. The SETCOM command affects 
only the standard RS-232 control blocks and routines. 

If OFF is specified, the RS-232 interface is turned off. No other optional 
parameters may be specified. 

If any of WORD, BAUD, STOP or PARITY is not specified, the state for that key- 
word is not changed. 

WOKD-wl specifies the number of bits per transmission byte, wl must be one of 
5, 6, 7 or 8. 

BADIMjr specifies the transmission rate (the baud rate) for both sending and 
receiving. The 16 allowable values for br are 50, 75, 110, 134, 150, 300, 600, 
1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600 and 19200. 

STOF=sb specifies the number of stop bits to be used for each byte transmit- 
ted, sb is either 1 or 2. 

PARITT=pp specifies the parity to be used in the transmission where 1 = odd 
parity, 2 = even parity and 3 - no parity. 

WAIT or 1ICWAIT are mutually exclusive and specify whether or not the RS-232 
input routine is to wait until an input byte is received and the output routine 
is to wait until the current byte has been sent. If neither WAIT nor NOWAIT is 
specified, the previous wait or no wait state remains. 

SETCOM command examples : 

1. SETCOM, WORD=8,BAUD=300,STOP=1,PARITY=1, WAIT Activates the RS=232 
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interface, if not already active, and sets the interface for 8 bit bytes, 
300 baud rate, one stop bit, odd parity and forces the RS-232 routines, 
when called, to wait until an input byte is ready or until the RS-232 
output device will accept an output byte. 

2. SETCOM^HOWAIT.PARITY^.WORIW Activates the RS-232 interface, if 
not already active, and sets the interface for 7 bit bytes, no parity and 
causes the RS-232 routines not to wait until an input byte is ready or the 
RS-232 output device will accept an output byte. The TRS-80 interrupt 
routines will handle the actual byte input or output with the RS-232 
device. The other parameters not mentioned in the command are not 
changed. 

3. SETCOM.OFF The RS-232 interface is deactivated. The current 
interface specification is remembered. 



2.45. STMT Display specified message. 

STMT,msg 

Since normal DOS commands are always displayed, this command normally has 
nothing to do since its function, to display the message msg, has already been 
done. However, if this command was invoked via DOS-CALL (which does not dis- 
play the DOS command), the message msg is displayed. 

STMT is one of 3 ways in chaining to display a message without a pause. This 
allows multiple line instructions to be displayed, with the last line being a 
PAUSE and the others being STMTs. 

STMT command examples : 

1. STMT PHASE ORE COMPLETED This is simply an announcement to the 
terminal operator that phase one (whatever that was) has been completed. 
DOS does not pause. 

2. STMT DISMOUNT AND STORE AWAY DISKETTE XXX 
PAUSE AND MOUHT DISKETTE YYY ON DRIVE 2. 

This example illustrates the combined use of the STMT and PAUSE commands 
to give instructions and wait until they are carried out. 



2.46. SYSTEM Change system options. 

SYSTEM, [pa sswordl : ]dnl[ ,AA=yn] [ ,AB=yn][ ,AC=yn] [ ,AD=yn] [ ,AE»yn] 
[ ,AF=yn] [ ,AG=yn] [ ,AI=yn] [ ,AJ=yn] [ ,AL-al] [ ,AM»=am] I ,AN=an] 
[ ,AO=ao] [ ,AP=ap] [ ,AQ=yn] [ ,AR=yn] [ ,AS=yn] [ ,AT=ynJ[ ,AU=yn] 
[ , AV=av] [ , AW=aw] [ ,AX=ax] [ ,AY«yn] [ , AZ-yn] [ ,BA-yn] [ ,BB-yn] 
[ ,BC=yn] [ ,BD=yn] [ ,BE=yn] [ ,BF*=yn] [ ,BG-yn] [ ,BH=«yn] [ ,BI»bi) 
[ .BJ=bj J [ ,BK=ynJ [ ,BM=yn] [ ,BN=yn] 
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The NEWDOS/80 system diskette whose control information is being updated/ 
displayed by this command is mounted on drive dnl. If passwords are enabled, 
passwordl must be specified and be equal to the diskette's master password. If 
no optional parameters are specified, then only a display of existing options 
is given. The optional parameters may be specified in any order, and only 
those parameters specified have their values changed in the diskette's control 
data (3rd sector on the diskette). Parameters not specified are not changed. 

If many options are being changed, it may be necessary to perform multiple 
SYSTEM commands as the DOS buffer is limited to 79 characters per command. 

It is anticipated that additional options will be specified as time proceeds. 

Changes to a system diskette's system options do not affect the computer 
operations until that system diskette is mounted on drive and a reset done. 

AA=yn If AA=Y, passwords are enabled. If AA«=N, passwords are disabled. 

AB-yn If AB=Y, the system is to operate in RUN-ONLY mode. SYSTEM options 
AD-N, AE=N and AF=N are forced at reset time, and the pressing of ENTER to 
override the auto command is disallowed. The user must have a proper auto 
command (see AUTO, section 2.4) that will either invoke a user program or exe- 
cute a CHAIN file that will eventually invoke a user program. In RUN-ONLY 
mode, if the system finds itself at normal DOS READY or MINI-DOS READY, it will 
go into an endless loop after displaying 'RUN ONLY STOPPED!! PRESS *R' FOR 
RESET 1 . Upon receiving R, the DOS command BOOT (see section 2.7) will be exe- 
cuted. BASIC honors RUN-ONLY by disabling BREAK, treating LOAD without R or V 
as an error, and by not allowing any direct statements. If AB=N, the system is 
in normal command mode. 

AC*yn (Model I only) If AC=Y and if SYSTEM option AJ=Y, the NEWDOS/80's 
debounce routine is used. If AC=N or SYSTEM option AJ=N, the NEWDOS/80's de- 
bounce routine is bypassed. 

AD«yn If AD=Y, , JKL' is enabled, and if AD-N, 'JKL' is disabled. 

AB=yn If AE=Y, , 123 t is enabled as the method to invoke DEBUG (see section 
4.1). If AE=N, '123' is disabled. 

AF«yn If AF=Y, *DFG* is enabled as the method of invoking MINI-DOS (see 
section 4.2). If AF=N, 'DFG' is disabled. 

AG»yn If AG^Y, BREAK is considered a normal input key with code ■ 01. If 
AG=N, the BREAK key is not considered a normal input key and its occurrence is 
changed to the null key code 00. The state of the BREAK key is set according 
to option AG at reset and then again everytime the system returns to normal DOS 
READY. DOS command BREAK may be used to enable or disable the BREAK key until 
the next normal DOS READY. Also, programs may enable the BREAK key by storing 
a 0C9H byte in Model I location 4312H (Model III location 4478H) or disable 
the BREAK key by storing a 0C3H byte in that location. 

AH=yn Not defined in NEWDOS/80, version 2. Formerly, this dealt with de- 
laying the disabling of timer interrupts during disk I/O to gain better clock 
accuracy. This is no longer done. 
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AI«yn (Model X only) If AI«Y, lower case modification has been installed 
in the computer and AI=N if it is not. User programs may test for bit 4 of 
436CH for this state, 1 if AI»Y and if AI=N. Currently, DEBUG and SUPERZAP 
use this flag to decide whether memory displays can display lower case. 

AJ-yn If AJ=Y, NEWDOS/80's keyboard intercept routine is active. This 
routine contains repeat key function, 'debounce' (Model I only) and one of the 
methods used to spot 'JUL', '123' and 'DFG' (the other being off the timer 
interrupts). If AJ-N, NEWDOS/80 does not intercept the keyboard two byte 
address vector at 4016H and 

1. The repeat key function for the Model I is not active regardless of 
the SYSTEM option AU. The Model III reverts to the ROM repeat key 
function. 

2. 'debounce' (Model I only) is not active regardless of SYSTEM option AC 
setting. 

3. 'JKL', '123 1 and 'DFG' can only be triggered via the interrupts, 
resulting in many more spurious key input characters. 

If the up-arrow key is depressed all during the reset/power-on sequence, AJ » N 
is forced; this is necessary for those programs that eventually overlay the DOS 
in main memory* 

AK=yn Not defined in NEWDOS/80, version 2. Formerly, this option dealt 
with allowing 'JKL' to pass graphic characters to the printer. This has been 
incorporated into SYSTEM option AX. 

AL"=al al (value 1-4) specifies the number of physical drives in the sys- 
tem. If your system only has one drive, setting al ■ 1 will limit the system 
to only checking for that one drive. Though al can be set to 255, it should 
never exceed 4. 

AM»a* am (value - 255 where " 256) is the number of tries allowed for a 
disk I/O before it is declared in error. The original DOSs used a value of 10. 

AS-an an = the default drive number for the DIR command. 

AD=ao When creating a file and when the user lets the system choose the 
diskette to contain the file by not specifying a drive number in the filespec, 
the system will first search all the drives for an existing copy of the file. 
If it does not find an existing copy, the system will start searching at drive 
ao, and will search that and higher numbered drives until a free FDE is found. 
It will not search a drive whose number is less than ao. 

AF™ap ap is a memory address, which if other than and is within the range 
of existing memory, is stored as DOS'e HIMEM address value in the two bytes at 
Model I location 4049H (Model III location 4411H). 

AQ»yn If AQ=Y, the CLEAR key is enabled, and if AQ-N, the CLEAR is disabled 
if SYSTEM option AJ=Y. 

Aft«yn If AR=Y, COPY, formats 5 and 6, are allowed without diskette password 
checking even though passwords are enabled. If AR=N, passwords are required if 
passwords enabled. 
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AS-yn (Model I only) If AS-Y, BASIC will convert input text character 
strings from lower to upper case. This is useful when lower case hardware is ^^ 
not installed or when lower case drivers are not used as it is very possible to Mm 
input lower case characters (using the shift key) and have BASIC display them ^^ 
as upper case even though they are really lower case. The user can stare for- 
ever at a compare that looks equal on the display, but BASIC computes as un- 
equal. If as - N, BASIC will leave the text character strings alone. This 
option does not affect string characters input as data rather than as part of 
text. 

AT=yn AT=N puts chaining into record mode, meaning that only requests for 
full records come from the chain file; single char key input request are hon- 
ored from the keyboard. AT=Y puts chaining in single character mode meaning 
that all requests for an input key come from the chain file. 

AI*«yii AU=Y turns on the clock driven repeat key function. The first repeat 
will delay option AV number of 25 ms intervals. Subsequent repeats will enter 
as fast as the program asks for them but not more than 12 per second. AU-N 
turns off the repeat key function, eliminating repeat keys on the Model I and 
shifting to the ROM repeat key function on the Model III. 

AV«av AV is used when AU=Y. av is the number of 25 ms intervals to pass 
between the key depression and the acceptance of the 1st repeat of that char- 
acter. Subsequent repeats are as fast as the program wants them but not more 
than 12 per second. 



AH»=aw is the number of write-with-verify disk I/O tries allowed. This I/O 
retry count works in conjunction with option AM=am with each retry under AW 
taking place only after the sector verify read has failed am number of times. 
Formerly, if sector write encountered no error and the verify read did result 
in an error, it was left to the user to retry the write. How, if aw is greater 
than 1, the write will automatically be retried in the cases where the write 
was apparently good but the verify read failed. 

AX-ax This is ASCII code of the highest printable character for the printer. 
It is used by system routines to determine when to substitute blanks or per- 
iods in place of ASCII codes higher than this value. This value must not ex- 
ceed 255. This high ASCII code is stored in the one byte at Model I location 
4370H (Model III location 429(BH) . 

AY-yn is used only during resets wherein DOS senses that it was not active 
immediately prior to the reset (i.e., reset after power-on or after execution 
of non-disk BASIC). AY=Y causes the operator to be asked for date and time. 
AY=H bypasses this query and causes date and time to be set to zeroes. 

AZ=yn is used only during resets wherein DOS senses that it was active 
immediately prior to the reset. AZ=Y causes the operator to asked for date and 
time. AZ=N causes date and time to be left as they were prior to the reset. 

BA=yn BA=Y causes a reset to activate , R0UTE,DO,NL' , thus causing all dis- 
play output, including the DOS and BASIC banners, to be lost until the operator 
or a user program executes either 'ROUTE, CLEAR* or 'ROUTE, DO'. BA-N disables 
this reset action. 

BB»yn (Model III only) BB=N informs the system that the clock interrupts 
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occur 60 times a second. BB=Y informs the system that the clock interrupts 
occur 50 times a second. This option does not set the clock to perform as 
such, but only acknowledges that it does. 

BOyn BC=Y means the operator can manually pause or cancel chaining. BOH 
means the operator is not allowed to manually pause or cancel chaining. HUN 
ONLY forces BON. 

BD=yn BD=Y means the operator can override the ADTO command at reset by 
holding down the ENTER key. BD-N means he/she can't. RUN ONLY forces BD=N. 

BE"yn BE=Y enables the DOS command R to repeat the previous DOS command 
(see section 2.41). BE=K causes the R command to simply return to DOS READY. 

BF^yn (Model 1 only) BF=Y performs at reset/power-on time the equivalent 
of the DOS command LCDVR.Y (see section 2.29). BF=N performs the equivalent 
of LCDVR,N. However, if DOS senses that the lower case hardware is either not 
installed or is not operating, BF=N is forced. 

BOyn BG n Y performs at reset/power-on time the equivalent of the DOS com- 
mand LC,Y (see section 2.28). BG=N performs the equivalent of LC,N . 

BH«*yn At reset/power-on time BH=Y enables cursor blinking, and BH=N in- 
hibits it. 

BJ>bi At reset/power-on time, the numeric value bi is set as the cursor 
character's value, excepting that if bi = 0, then the standard cursor character 
value is used (95 for the Model I and 176 for the Model III). 

BJ«bj Option BJ provides a minimal control for NEWDOS/80 when a CPU speed 
up modification is installed that is to continue operation during disk opera- 
tions. This option multiplies (roughly) by bj the number of Z— 8Jft instructions 
executed during certain timing loops used internal to NEWDOS/80. bj must be an 
integer greater than and equals the number of times the CPU haB been speeded 
up. Set bj = 1 if the loops are not to be lengthened. If the loops are to be 
lengthened, bj must always be rounded up in the cases where the new CPU speed 
is not an even multiple of the original Model I or Model III speed. Option BJ 
does NOT perform the actual CPU speed switching. 

BK-*yn BK=Y allows the DOS command WRDIRP and the W and C functions of 
DIRCHECK to be executed. BK=N causes these functions to be rejected with 
'DISK ACCESS DENIED'. 

HM=yn BM=Y causes diskette formatting to verify read sectors in a separate 
VERIFYING phase after all tracks have been formatted. This verify read is in 
addition to the verify read done on a track's sectors immediately after the in- 
dividual track was formatted. BM=N bypasses this VERIFYING phase, deeming as 
sufficient the verify sector read done when the individual track was formatted. 

BJHyn (Model I only) BN=N causes the write of single density diskette 
directory sectors to use the address mark readable by Model I TRSDOS. BN=Y 
causes the write of single density diskette sectors to use the address mark 
readable by Model III NEWDOS/80. BN=Y should only be used where it is required 
that single density diskettes be NEWDOS/80 version 2 exchangeable between the 
Model I and the Model III. 



2-49 DOS LIBRARY COMMANDS 



SYSTEM - TIME 



Though the information contained in the directories used by Model I 
TRSDOS, Model I NEWDOS/80 and Model III NEWDOS/80 is the same (except for 
some additions by NEWDOS/80), the address mark byte (part of the magnetic 
format and identification bytes that surround each 256 bytes of user data 
on the soft sectored diskettes) used to indicate the directory sectors are 
'protected' is different on the Model III than it is on the Model I for 
single density diskettes. 

The changing of SYSTEM option BN does not in itself change the address 
mark of any directory sectors. All this does is set the protected sector 
write routine in DOS to write the specified address mark whenever a pro- 
tected sector is written or rewritten to disk. To set all sectors of a 
single density diskette directory to the proper address mark, use either 
DOS command WRDIRP or DIRCHECK with the W option. Warning Ml If a single 
density diskette has been used on the Model III or has been used on the 
Model I where BN=Y and the diskette must now be used with Model I TRSDOS, 
the user must set BN=H and rewrite the directory sector address marks 
using WRDIRP or DIRCHECK with option W. This must be done even though, 
with BN=N, SUPERZAP under NEWDOS/80 on the Model I shows the directory 
sectors protected; this is because Model I NEWDOS/80 accepts either 
address mark value as 'protected 1 though it only writes the one value 
specified by option BN. 

System option codes BO and up are reserved for future definition. 
SYSTEM command examples : 

1. SYSTEM,0,AL=4,AA=Y,AU=Y,AV=20 ) AT=Y The SYSTEM control parameters 
AL, AA, AD, AV and AT are changed on the current system diskette mounted 
on drive 0. All the other SYSTEM parameters are left unchanged. The full 
SYSTEM specification is then displayed. These changes are not used to 
control NEWDOS/80 until the next reset/power-on. 

2. SYSTEM, 2, AP=0FF00H,AN=1,AX=126 The SYSTEM control parameters AP, 
AN and AX are changed in the control sector of the diskette currently 
mounted on drive 2. No other SYSTEM parameters are changed. The full 
system specification contained on that diskette is then displayed. For 
the SYSTEM parameters contained on that diskette to control NEWDOS/80, 
that diskette must be a NEWDOS/80 version 2 system diskette, must be dis- 
mounted from drive 2 and remounted on drive 0, and a reset/power-on must 
be done. 



2.47. TIME Set the real time clock. 
TIME[ ,hh:mm:ss] 

If no parameters are specified, the current times is displayed in hh:mm:ss 

format. 

If hh:mm:ss is specified, the clock is set to time hh:mm:ss where hh is a 2 
digit hour value, 00 - 23 , mm is a two digit minute and ss is a two digit 
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seconds value. No check is made on the validity of the values. Each of the 
three values is converted to a single byte value and stored into its byte of 
the clock. The clock three bytes start at model I location 4041 H (model III 
location 4217H) and are in seconds, minutes, hours order. 

At reset /power-on the clock is set according to SYSTEM option AY or AZ. The 
clock is updated once a second. The user should not rely upon the clock for an 
accurate value as disk I/O frequently and interrupt routines infrequently run 
so long with interrupts disabled that one or more timer interrupts will be 
missed, causing the clock to run slow. The real time clock is not a hardware 
clock, but instead is maintained by software that is not aware of the lost 
timer interrupts. 

TIME command examples : 

1. TIME.15: 23:00 The clock is set to 3:23 PM. 

2. TIME The current time is displayed. 



2.48. VERIFY Require verify read after every disk write. 
VERIFY[ ,yn] 

NEWDOS/ 80 performs verify read after all of its directory writes and after all 
sector writes when logical record or single byte I/O is used. It does not per- 
form verify reads when full sector writes are done via the 443 9H vector. 

VERIFY or VERIFY, Y Diskette writes done via the 443 9H vector are verify 
read. A verify read means the sector is read after it is written. If the sec- 
tor was written illegible or with bad parity, an error will be triggered. A 
byte for byte data compare is not done. However, if the verify read detects an 
error and SYSTEM option AW is not equal to 1, the write and verify read will be 
done again since the system still has access to the data that should have been 
placed into the diskette sector. 

VERIFY ,N Diskette full sector writes done via the 443 9H vector are not 
verify read. 

COPY, EDTASM and BASIC SAVE's write the file completely without validity read, 
but then read back the entire file as a verify read. All BASIC disk data 
writes to print/input files, marked item files, fixed item files or field item 
files (where record length is not 256) perform verify read due to the fact that 
byte rather than sector I/O is used. Field item files with record length 256 
use sector I/O and are not verify read unless VERIFY is on. 
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WRDXBP 

2.49. W&DX1F. Write directory sectors protected. 

WRDIRP, dnl 

WRDIRP causes the directory sectors for the diskette in drive dnl to be read 
and rewritten in the currently defined protected state for the current computer 
(see SYSTEM options BN and BK), 

This command is used where single density diskettes are to he exchanged under 
NEWDOS/80 version 2 between the model I and III. 

This command enables the user to set the directory to the proper read protect 
state while under MINI-DOS, since it is most likely he/she will find out about 
the problem when in the middle of doing something else (and thus can't get to 
DIRCHECK). CAUTION! It This command uses the directory starting granule number 
from the 3rd byte of the boot sector to find the directory. It then checks to 
see if the FPDE's for BOOT/ SYS and DIR/SYS are present. If these checks pass, 
it then changes what it thinks are the directory sectors all to protected 
status. Do NOT use this command unless you are sure the only problem is the 
different protection status between the model I and model HI; if you have 
doubts, use the W function of DIRCHECK. 

If SYSTEM option BK - N, the DOS command WRDIRP is disabled. 

WRDIRP command example: 

1. WRDIRP, 1 For the diskette mounted on drive 1, the directory 
address marks are set for the current computer and, if Model I, for the 
setting specified by SYSTEM option BN. 
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3. DOS ROUTINES. 



3.1. This chapter specifies the DOS routines that are available for use by 
machine language programs. If you are neither a Z— 80 programmer nor 
interested in Z-80 machine code, you should bypass this chapter. Readers of 
this chapter are assumed to be knowledgeable of Z— 80 machine code and at least 
one assembly language for the Z-80. 

These DOS routines have entry and exit conditions, and rather than repeat them 
in each routine's specification, some of the conditions are defined here with 
the using routine's specification simply refering to the condition's code. 

A. Only register AF is altered by the routine. Any other registers used 
by the routine are saved on entry and restored on exit. 

B. On exit, Z state is set if no error is encountered during the 
routine's execution. NZ state is set if a DOS error is encountered, and 
register A contains a DOS error code. The setting of Z and NZ takes 
precedence over the setting of other flags such as C and NC. 



C. On entry, DE points to an open FCB. 



There are incompatibilities with TRSDOS in the use of some of these routines. 
They are discussed briefly in the routines where they occur, so study them 
carefully. The reader should also be aware of the differences in the way the 
FCB fields NEXT and EOF are maintained (see FCB specification, section 5.9). 

The discussion of each routine gives its entry address (the address to be used 
in the CALL or JP Z-80 instruction), then its title (if one is appropriate), 
and then its specification. 

Unless otherwise specified, the DOS routine uses the invoker's stack. Unless 
specified as a dead end routine, the DOS routine exits to the caller. 

Many of these routines use a FCB (see section 5.9). NEWDOS/80 on both the 
Models I and III and Model I TRSDOS all use a 32 byte FCB while Model III 
TRSDOS uses a 50 byte FCB. REWDOS/80 will run with user programs having the 50 
bytes FCB but will only use the first 32 bytes of those FCBs. Programs using a 
32 byte FCB with Model III TRSDOS will have problems. 

The routines listed below are not necessarily in ascending numeric order. 



3.2. 402DH. No-Error Exit. Dead end routine. Programs concluding 
with no error jump to 402DH. DOS checks its own state in the following order. 

If either MINI-DOS or DOS-CALL, the stack pointer is set to where it was 
before the last DOS command; otherwise it is set to DOS's stack area and 
the BREAK key is enabled/disabled according to system option AG. 
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If SOS-CALL and if either not chaining or chaining is not to he continued 
at the current DOS level, all registers except AF are restored to as they 
existed on DOS-CALL entry, Z state is set, and a return is made to the 
DOS-CALL invoker. If this was the outermost DOS-CALL level* DOS is taken 
out of DOS-CALL state. 

If RUN-ONLY and if chaining is not active, the message 'RUN ONLY STOPPED!! 
KEY 'R' FOR RESET.' is displayed, DOS loops waiting on the reply, and then 
executes DOS command BOOT (see section 2.7). 

If DOS-CALL and if chaining is to continue at the current DOS-CALL level, 
DOS waits for the next command from the chain file. 

If MINI-DOS, then MINI-NEWDOS/80 READY is displayed, and DOS waits for the 
next command. 

If chaining is active, DOS waits for the next command from the chain file. 

NEWDOS/80 READY is displayed and DOS waits for the next input command. 



3.3. 4030H Error-already-displayed DOS Error Exit. Dead end routine. 
Programs concluding with an error that is either already displayed or not to be 
displayed jump to 4030H. DOS action is the same as for 402DH except as 
follows : 

If CHAINING, chaining is aborted. 

If DOS- CALL, the current DOS-CALL level is exited in the same manner as 
for 402DH, except that C state is set. 



3.4. 440 0H Performs identical to 402DH. 



3.5. 440 SH Alter DOS and execute a coamand. Dead-end routine. DOS is 
entered, and the stack pointer is set to DOS's own area, HL points to a com- 
mand, terminated by a 0DH byte, that DOS is to use as its next command. DOS 
moves this command to its own 80 byte command buffer and then executes it. 



3.6. 4409a DOS Error Exit. Dead end routine if bit 7 of register A 
equals 0, Programs terminating with a DOS error jump to 440 9H with the DOS 
error code in register A and bit 7 of register A equal 0. Depending upon DOS's 
state, the following actions occur: ^^ 

If CHAINING, chaining is aborted. ^^ 
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If DOS-CALL, the current BOS-CALL level is exited in the same manner as 
for 402DH exit, except NZ and NC state is set and the DOS error code is in 
register A. The error msg is not displayed. 

Otherwise the DOS error message is displayed, and an exit is taken to 
402DH. 

A program may CALL 4409H to display an error msg by placing the error code 
in A and setting bit 7 of register A equal to 1. The appropriate DOS error 
message will be displayed. On return, only the F register has been altered. 

The Model I TRSDOS will print diagnostics if bit 6 of register A equals 0. The 
Model III TRSDOS displays only the error number if that bit equals and the 
error message if that bit equals 1. HEWDOS/80 ignores the value of that bit. 

Debugging hint. By setting the 4 bytes at 440 9H equal to CD 0D 44 C9, the er- 
ror display routine can be made to invoke DEBUG instead of displaying the error 
message. 



3.7. 440 DH Enter DEBUG. User programs have two methods of entering the 
DEBUG facility: (1) by use of Z-80 instruction EST 30H and (2) by the Z-80 in- 
struction CALL 440DH. When done with the DEBUG facility, DEBUG command G will 
return to the instruction following the RST 30H or the CALL, provided the PC 
register was not changed. 



3.8, 4410H (447BH in Model III) Enqueue a user timer interrupt routine. 

Registers AF, BC, DE and HL are altered by this routine. On entry, DE points 
to the user interrupt routine which must conform to the following format: 

1st 2 bytes. Used by DOS as a forward chain pointer. On entry, the two 
bytes can be any value. 

3rd byte. The number of 25ms intervals to pass between invocations of the 
user's routine. Example, if the routine is to be invoked every second, 
the 3rd byte must be set = 40 (28H). DOS does not alter this byte. 

4th byte. Count down value to the next invocation. On entry, this byte 
should be properly initialized to a value greater than but less than or 
equal to the value in the 3rd byte. Every 25ms interrupt, DOS decrements 
this value. If the result is non-zero, this routine is bypassed for this 
25ms interrupt. If the result = 0, the value from the 3rd byte is moved 
into the fourth byte, registers HL, DE, BC and AF are saved, and the user 
routine is called at its 5th byte. Any other registers used by the 
routine must be saved/restored by it. Interrupts are disabled, and the 
user routine must not re-enable them. 

While a user interrupt routine is in the interrupt chain, it must not be al- 
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tered in any way except by a routine that runs with interrupts disabled; the 
first two bytes must never be altered. 

Model I TRSDOS uses the 4 vectors, 4410H, 4413H, 4416H and 4419H, for its user 
interrupt routine handling. NEWDOS/80 uses only 441 0H and 4413E for non- 
compatible handling of these routines. Any program using a 25ms interrupt user 
routine in TRSDOS must be modified to work under NEWDOS/80, This is a major 
incompatibility between the two Model I systems. 

Model III TRSDOS has not yet made any provision for user timer routines, using 
4410H - 441BH for other purposes, including HIMEM. 

Model III NEWDOS/80 continues with the user timer interrupt routine mechanism 
used on the the Model I, except that 447BH is the routine enqueue vector 
instead of 4410H, and in order to continue with 25 ms counting where the Model 
III clock actually counts in either 30ths or 25ths of a second, a second pass 
through the user routine check and invocation sequence is done when necessary 
to bring 25ms counting up with the real clock. If a user routine is being in- 
voked every 25 ms, the routine must be prepared to accept two invocations 
within the same timer interrupt. 



3.9. 4413H Dequeue a user tiaer interrupt routine. Registers AF, BC, 
DE and HL are altered. The user interrupt routine (as described in section 
3.7) pointed to by register DE is taken out of the 25ms interrupt chain, if it 
is in the chain. The routine no longer participates in the interrupts and may 
now be altered at will by the user. 

See section 3.8 for TRSDOS incompatibility. 



3,10. 441 6H Keep drives rotating. If the disk driveB are rotating, 
reselect the current drive, thereby keeping the drives rotating for approxi- 
mately 2.4 seconds more. RegiBter AF is altered. 

This routine does not exist in TRSDOS; see section 3.8 for incompatibility. 



3.1.1. 441 9H DOS-CALL. Execute a DOS camoaad and return. This routine 
is DOS-CALL. DOS does not shift to its own stack area, but instead remains 
with the user's stack. All registers except AF are saved in the stack and will 
be restored on return. The command to be executed is pointed to by HL, must be 
less than 80 characters, must terminate with byte 0DH, and can be anything 
legal for the current state DOS is in. DOS sets DOS-CALL state, if not already 
set, saves the current stack pointer, and executes the command. The command 
can be the invocation of a user program. 

DOS-CALL is now legal under CHAINING where it was not in NEWDOS/80 Version 1. 
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DOS-CALL is the way BASIC executes the DOS command contained within the BASIC 
statement CMD"xx" where xx is the DOS command. 

The DOS-CALL caller is responsible for assuring that memory conflicts do not 
arise and that sufficient stack space is available. 

Nested calls to DOS-CALL may be executed. Upon exiting from a DOS-CALL level, 
the return is made to the next outer level. When the outermost level is exit- 
ed, DOS leaves DOS-CALL state. 

If the DOS command invokes a program, that program may use its own stack area, 
and it must exit using one of the three exits: 402DH, 4030H or 4409H. On 
exiting, the program may store a 2 byte parameter in 4403H, 4404H (17411, 17412 
decimal) for use by the caller. 

The 441 9H vector is used differently in TRSDOS; see section 3.8 for incompati- 
bility. 

See section 4.4 for further discussion of DOS-CALL. 



3.12. 441 CH Extract a filespec. From the text pointed to by HL, ex- 
tract a filespec, place it in the area pointed to by DE and terminate it with 
the byte 03H. Registers AF, BC and HL are altered. 

If the first text character is A - Z or - 9, or if the first text character 
is * and the next character is A - Z or - 9, text is moved from the HL area 
to the DE area until a character that is not /, ., :, A - Z, or - 9 is en- 
countered or until 32 bytes have been transferred. If less than 32 bytes, a 
03H byte is placed after the last byte in the DE area to indicate end of file- 
spec, and a return is made with Z state set. If the filespec is more than 31 
characters it is considered improper as discussed in the following paragraph. 

If the first character was improper, or if the first character was * but the 
2nd was improper, a return is made with NZ state set. 

On exit, if the terminator/improper byte equals 03 or 0DH, then HL points to 
that byte; otherwise HL points to the next byte. 

The user will notice that NEWDOS/80 doesn't check for an exact filespec; it 
leaves this to be done by the OPEN routines, 4420H and 4424H. 



3.13. 4420H Open a FCB to a new or existing disk. file. Conditions 
3.1. A and B hold. The entry requirements are the same as for 4424H, which is 
executed immediately as a subroutine to this routine. If 4424H is successful 
in opening an existing file, no further action is required here, and an exit is 
taken with Z and NC states set. If the file was not found, this routine pro- 
ceeds to create the file* 

If the filespec in the FCB pointed to by register DE specifies an explicit 
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drive number and the diskette mounted on that drive has a free FDE, the file 
is created on that diskette whether or not the diskette actually has any free 
space. If the filespec did not specify a drive number! the system starts 
searching mounted diskettes, starting with the drive number specified by 
SYSTEM option AO and preceding through higher numbered drives until a diskette 
with a free FDE is found. If a free FDE is not available, the file cannot be 
created, and the error exit is taken. 

Creating a file consists of converting a free FDE to a FPDE. This entails in- 
serting the name and name extension (if any), encoding the password (if any) 
as both the update and access passwords, storing the LRECL (0 means 256) from 
register B, setting the EOF equal to 0, setting access level as FULL, and 
marking the file non-system, non-invisible. No diskette file space is 
assigned to the file at this time; in fact, DOS doesn't even look to see if 
the diskette has any free space. Hote, though the LRECL is stored in the FPDE 
during file creation, it is never used. Each subsequent open of the file uses 
the LRECL provided in register B. 

After the file is created, the DOS routine at 4424H is called to perform the 
OPEH. On exit after a successful file create and open, Z and C states are 
set. 



3.14. 4424B OFEH a FCB to an existing file. Conditions 3.1. A and B 
hold. On entry, register DE points to a FCB containing the filespec for the 
file to be opened, HL points to a 256 byte buffer to be used during disk 
sector reads and writes for this FCB, and B contains the LRECL (0 = 256). If 
an explicit drive number was specified in the filespec, the search for the 
file is limited to that drive; otherwise the search starts with drive and 
proceeds to higher drives until a file with the specified name and name 
extension is found. If no file is found, the error exit is taken. 

If passwords are enabled and the file has non-null passwords, then an error 
exit is taken if the filespec does not contain either the update or the access 
password. If passwords are disabled or the file has no passwords or the 
update password is specified, the FCB's access level is set to FULL; otherwise 
the access level from the FPDE is placed into the FCB to limit the type of 
access for this file. 

The FCB is converted from containing the filespec to containing information 
about the file, which will be used while the FCB is open to reduce the amount 
of directory I/O which would otherwise be required. The conversion entails 
copying the EOF and the 1st 4 extents from the FPDE, storing the LRECL from 
register B, setting bit 7 of the FCB's 2nd byte equal to 1 if LRECL is not 
equal to (to indicate logical record processing), setting NEXT equal to 0, 
storing the drive number and the FPDE's DEC code, storing the 256 byte buffer 
pointer from register HL, setting the access level, setting bit 5 of the FCB's 
2nd byte equal to 1 to indicate that the buffer does not contain the current, 
sector and setting bit 7 of the FCB's 1st byte equal to 1 to indicate that the 
FCB is open. 
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3.15. 4428H CLOSE a FCB. Conditions 3.1. A, B and C hold. This routine 
dissolves the connection between the FCB and the file. If bit 4 of the FCB's 
2nd byte equals 1, the FCB's buffer is written to disk like a 4439H call. If 
the FCB's EOF is different from that in the FPDE, the FPDE is updated for the 
new EOF. If the file has excess granules beyond EOF and if automatic space 
deallocation is allowed, the excess granules are released. The FCB is then 
converted back to contain a filespec consisting of the file name, name exten- 
sion (if non-blank) and the drive number. This filespec can be used later to 
re-open the file, provided a password is not required. 



3.16. 442CH Kill the FCB's associated file. Conditions 3.1. A, & and C 
hold. The file associated with the FCB is killed in the same manner as for DOS 
library command KILL (see section 2.27). The FCB is set to all zeroes. 



3.17. 4430H Load a program file. Conditions 3.1. A and B hold except the 
registers AF, BC and HL are altered and on exit HL (and 4403H - 4404H (17411 - 
17412 decimal)) contain the program's entry address. On entry, register DE 
points to a FCB containing the program file's filespec. The load is done the 
same as for DOS library command LOAD (see section 2.32). 



3.18. 4433H Load and coamence execution of a program file. Dead end 
routine. On entry, DE points to a FCB containing the program file's filespec. 
Registers AF and BC are altered; all other registers are passed on unchanged to 
the program when its execution begins. The file open, load and commence exe- 
cution are done the same as when DOS executes a command that is not a library 
command, excepting that there is no default name extension. If an error occurs 
during the open or load, DOS exits to 4409H. If DEBUG is active (see section 
2.17), DEBUG is entered just before the program commences execution. 



3.19. 4436E READ a disk sector or wore a logical record froa the FCB's 
buffer to the caller's buffer. Conditions 3.1. A, B and C hold. 

If bit 7 of the FCB's 2nd byte equals 0, the sector represented by the high two 
bytes of the NEXT field is read into the FCB's buffer and, if no error or if 
error code 6 (sector read protected) > the HEXT field is advanced 256 bytes. If 
an error other than code 6 occurs, the NEXT field is not advanced, meaning the 
user can retry to read the same sector. 

If bit 7 of the FCB's 2nd byte equals 1, then a logical record of length equal 
to the FCB's LRECL (where means 256) is moved from the FCB's buffer to the 
buffer pointed to by register HL on entry. As each byte is moved, the NEXT 
field is incremented. When the FCB's buffer is empty, the next file sector is 
automatically read into it and byte movement continues. If an error occurs, 
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including error code 6, the logical record move terminates, leaving NEXT 
advanced for the number of bytes moved. 

If bit 1 of the FCB's 1st byte equals 1, the NEXT and EOF fields are considered 
RBA 1 s within the diskette rather than within a file, thus giving the user the 
capability to read a diskette, rather than a file. The use of bit of the 
FCB's first byte is defined in section 3.20 below. DOS routines 0013H, 001BB, 
4439H, 443CH and other routines that indirectly read or write sectors also 
operate as such if any of these two bits are on. The use of these 2 bits is 
incompatible with TRSDOS. 

One incompatibility between HEWDOS and TRSDOS occurs when the program reads the 
EOF from the FCB to determine the number of bytes in the file. However, in 
many cases the user does not have to know what the EOF is. Instead, for both 
TRSDOS and NEWDOS, the user can read the file sector by sector, waiting for 
either of the two EOF errors. If the error code is 1CH (END OF FILE 
ENCOUNTERED) , then the file ends on a sector boundary and the last sector read 
successfully was the file's last. If the error code was 1DH (PAST END OF 
FILE), then the last sector successfully read was also the file's last, but was 
only a partial Sector with the value in FCB+8 equaling the number of bytes in 
that sector belonging to the file. Remember, this is true for both TRSDOS and 
NEWDOS; thus the same code can work for both. 



3.20. 4439H WRITE without verify a sector to disk or «ove a logical record 
from the caller's buffer to the FCB's buffer. Conditions 3.1. A, B and C hold. 

IF bit 7 of the FCB's 2nd byte equals 0, the disk sector as defined by the NEXT 
field is written with the contents of the FCB's buffer. Unless VERIFY is on 
(see section 2.48), verify read is not done. If no error, and if the lower 
order byte of NEXT equals 0, the NEXT field is advanced 256 bytes. Whether or 
not NEXT was advanced, if NEXT now exceeds EOF or if bit 6 of the FCB's 2nd 
byte equals 0, EOF is set equal to NEXT. If an error occurred, NEXT is not 
altered, thus allowing the user to retry 'to write the same sector. 

If bit 7 of the FCB's 2nd byte equals 1, a logical record of length equal to 
the FCB's LRECL (0 means 256) is moved from the caller's buffer, pointed to by 
register HL on entry, to the FCB's buffer. With each byte's move, NEXT is in- 
cremented, and if NEXT now exceeds EOF or if bit 6 of the FCB's 2nd byte equals 
0, EOF is set equal to NEXT. When the FCB's buffer fills, the buffer is writ- 
ten to the appropriate disk sector with verify read and then the logical record 
move continues, filling in the FCB's buffer for the next file sector. Whenever 
an error occurs, the logical record move terminates, leaving NEXT advanced for 
the number of bytes moved. 

Bit 1 of the FCB's 1st byte functions as described in section 3.19. If bit 
of that byte equals 1, then sectors are written protected (error code 6 on 
sector read). 

If a verify read is done after the write of a protected sector, error code 6 is 
not returned to the caller as an error. 

A significant incompatibility with TRSDOS lies in the fact that when a sector 
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is written to disk in NEWDOS/ 80 and the low order byte of NEXT is non-zero, 
NEXT is not advanced by 256 bytes. In this case, NEWDOS/80 assumes that the 
caller is writing the last sector of the file (though it need not be) that is 
only partially full, and that NEXT already is the proper RBA value for EOF (if 
EOF is to be updated by the write). 

One incompatibility between NEWDOS and TRSDOS is in setting the final EOF for a 
file that is written sector by sector but usually does not end on a sector 
boundary. However, if the program knows when it is about to write the last 
sector, whether partial or full, and can store the desired low EOF byte value 
in FCB+5 just before writing that last sector, both TRSDOS and NEWDOS will exit 
from that write with the same EOF. Thus, in this instance, the same program 
code will work for both TRSDOS and NEWDOS, and no incompatibility exists. 



3.21. 443CH This routine is identical to 4439H, except that a verify read 
is always done after a sector write. 



3.22. 443FH Position FCB to start of file. Conditions 3.1. A, B and C 
hold. If the FCB has a sector awaiting write (bit 4 of FCB 2nd byte =1), it 
is written as a 4439H call. The FCB NEXT field is set = 0. Bit 5 of FCB 2nd 
byte is set = to indicate the buffer does not contain the current sector. 



3.23. 4442H Position FCB to a specified file record. Conditions 3.1. A, 
B and C hold. The NEXT field is set to the RBA of the logical record whose 
relative record number (0 = the first record) is in register BC upon entry. If 
the new NEXT is in the same sector as the old NEXT, the status of the current 
sector is not changed (i.e., the sector is not written to disk if bit 4 of the 
FCB 2nd byte equals 1). If the new NEXT is not in the same sector as the old 
NEXT, then (1) if bit 4 of the FCB 2nd byte equals 1, the old sector is written 
back to disk, and (2) bit 5 of the FCB 2nd byte is set to 1 to indicate that 
new sector has not yet been read into the buffer. 



3.24. 4445H Position FCB back one record. Conditions and performance 
are the same as 4442H except that the NEXT field is reduced by the LRECL. 



3.25. 4448H Position FCB to EOF. Conditions and performance are the 
same as 4442H except that the NEXT field is set equal to the EOF field. 
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3.26. 444BH Allocate file space. Conditions 3.1. A, B and C hold. If 
the file sector represented by the two high order bytes of the FCB's NEXT field 
is not already allocated to the file, the granule containing it is allocated 
along with the granules for any lower sectors for the file that are not yet 
allocated. This allows the programmer to allocate file space before it is 
actually needed, and is especially valuable when it is necessary to know that a 
sector can be written before any data iB placed in the buffer. If a file's 
size can be predetermined before being written (such as is done in COPY), 
pre-al locating the necessary granules saves considerable time over allocating 
the granules as the file write proceeds. 

This address is defined differently in TRSDOS. 



3.27 444EH Position FGB to the specified ERA. Conditions and performance 
are the same as for the 4442H call except the new NEXT position value is taken 
from the registers H, L and C where H contains the high order and C the low 
order values. 



This address is defined differently in TRSDOS. 



3.28 4451B Write the EOF value from the FOB to the directory. Conditions 
3.1. A, B and C hold. If the EOF value in the FCB differs from that in the 
file's FPDE, the FCB's EOF value is written into the FPDE on disk. 

This address is defined differently in TRSDOS. 



3.29. 445BH Select and power up the specified drive. Conditions 3.1. A and 
B hold. On entry, register A contains a drive number* That drive becomes the 
current drive, is selected and, if necessary, powered up. 



3.30. 445SU Test for mounted diskette. Conditions and performances is the 
same as for 445BH excepting that, in addition, the drive is tested to deter- 
mine if a diskette is mounted and is rotating. If this rotation test fails, 
error code 08, DEVICE NOT AVAILABLE, is returned. 



3.31. 446111 *name routine enqueue. Register HL points to a user routine 
in main memory to be chained in the chain of user logical routines. The first 
12 bytes of the routine are defined as follows: 

4 bytes reserved for use by DOS only. 
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8 byte logical routine name field containing the 1-8 character name of 
the routine, padded on the right with blanks. 

If a routine with the same name already exists in the queue, FILE ALREADY 
EXISTS error code is returned with NZ set. Otherwise the routine is enqueued, 
and exit taken with Z state set. HL, DE, BC and AF are altered by this func- 
tion. This function is new with NEWDOS/80. 

Subsequently, whenever a DOS command of the form *namel or *namel , parameters 
is executed, DOS searches its queue for a routine named namel , sets HL point- 
ing to the parameters, if any, and jumps to the routine's 13th byte. When the 
routine concludes, it should exit via 402DH, 4409H, or 4030H. The routine may 
use all registers, and can use the two bytes at 4403H - 4404H to receive or 
pass back a parameter. If the logical routine namel does not exist in the 
queue, FILE NOT IN DIRECTORY error code is returned with NZ set. 



3.32. 4464B *name routine dequeue. HL points to a logical routine as 
defined in section 3.31. If the routine is not in DOS's logical routine queue, 
this function exits with FILE NOT IN DIRECTORY error code in register A and 
with NZ set. Otherwise, the routine is dequeued, meaning that subsequent 
*namel commands naming it will abort, displaying FILE NOT IN DIRECTORY. 
Registers HL, DE, BC and AF are altered by this function. This function is new 
with NEWDOS/80. 



3.33. 4467H Send Message to the display. Condition 3.1. A holds. The 
message bytes pointed to by HL up to and including a 0DH byte (EOL) or up to 
but not including a 03H byte (EOM) are sent to the display. 



3.34. 446AH Send message to the printer. The same as 4467H except the 
message is sent to the printer. 



3.35. 446DH Convert clock time to HH:MM:SS character format. The current 
clock value at Model I locations 4041H - 4043H (Model III locations 4217H - 
421 9H) is converted to HH:MM:SS character format and stored in the 8 bytes 
pointed to by HL. Registers AF, BC, DE and HL are altered. On exit, HL points 
to the next byte after the HH:MM:SS field. 



3.36. 4470H Convert the date to MK/DD/YY character format. This routine 
is the same as 446DH, except the date value at Model I locations 4044H - 4046H 
(Model III locations 421AH - 421CH) is converted to MM/DD/YY format. 
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3.37. 4473H Insert default nave extension into fileapec. If the file- 
spec pointed to by register DE has no name extension, insert the 3 characters 
pointed to by HL as its name extension* The resulting filespec cannot exceed 
31 characters* Registers AF and HL are altered. 



3.38, 0013H Seed a byte from a disk file. This is DOS's single byte read 
routine even though it starts in ROM. Conditions 3.1. A, B and C hold. If the 
disk sector containing the NEXT byte of the file is not in the FCB's buffer, it 
is read into there. The byte is then placed into register A for use by the 
caller. The FCB's NEXT field is incremented. 




3.39. 001BH Write a byte to a disk file. This is DOS's single byte write 
routine, even though it starts in ROM. Conditions 3.1. A, B and C hold. If the 
disk sector corresponding to the FCB's NEXT position is not in the FCB's buf- 
fer, it is read into the buffer, unless NEXT is on a sector boundary and is 
equal to EOF. The byte in register A on entry is placed into the buffer, and 
NEXT is incremented. If the buffer is now full, the sector is written to disk 
as if a 443CH call. 



3.40. 447BH For Model III only, performs the same function as call 441 0H II 

does for the Model I (see section 3.8). For the Model III, 4410H must not be 

used. 
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4. DOS FEATURES . 

This chapter discusses DEBUG, MINI-DOS, CHAINING, DOS -CALL, JKL and asynchro- 
nous execution. DEBUG, DOS-CALL and asynchronous execution are primarily of 
interest to machine language programmers and those interested in Z-80 code. 
Other users should make a quick reading of DEBUG and DOS -CALL as they are fre- 
quently referred to elsewhere in the manual. MINI-DOS and JKL can he used im- 
mediately by everyone. CHAINING can be very complex; novice users will want to 
test out the chaining concept by using the BASIC program CHAINBLD/BAS to first 
inspect the sample chain file CHAINTST/JCL and then to create some elementary 
chain files. 



4.1. DEBUG Facility. 

As an aid primarily for the machine language programmer but also for use by 
higher level language programmers, NEWDOS/80 has the DEBUG facility for inter- 
rupting current execution, inspecting memory, altering memory, inspecting disk, 
altering disk, single step execution, etc. 

DEBUG can be entered in three ways: 

1. Simultaneously depressing the three keyboard keys 1, 2 and 3. In 
order for this 123 action to work the follow conditions must be met. 

1. SYSTEM option AB = N. 

2. SYSTEM option AE = Y. 

3. Either (1) interrupts are enabled or (2) the main program is 
awaiting keyboard input via the standard keyboard input routine and 
SYSTEM option AJ = N. 

4. DOS must not be currently using its overlay area (main memory 
locations 4D00H - 51FFH. 

5. DOS must not have its overlay inhibit enabled. 

2. Executing either a RST 30H or a JP 440DH or a CALL 440 DH 2-80 
instruction. 

3. Automatically at, but before, a machine code program commences execu- 
tion if DEBUG has been turned on via DOS command DEBUG (see section 2.17). 

Upon entry, the DEBUG facility will (1) save all registers in the interrupted 
program's stack, (2) use the next stack locations for its own operations, (3) 
disable any stops that may have been set on its last exit, (4) display memory 
using mode and locations as remembered from its last exit, and (5) display the 
cursor in the lower right hand corner of the display to indicate that the DEBUG 
facility is awaiting an input command. 

All commands, even the single character commands, to the DEBUG facility must 
terminate with ENTER. If an error is made in keying in a command but before 
ENTER is depressed, simply backspace over the incorrect characters and type in 
the correct ones. If desired, the command may be pureed before ENTER by keying 
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shift left arrow. 

Both the X and S displays display memory 16 bytes per display line, both in 
hexadecimal and in character format. If SYSTEM option AI - Y, character for- 
mats will include lower case letters. 

When DEBUG encounters an error condition, it displays 'ERROR 1 and waits for the 
user to acknowledge the error which is done by pressing ENTER to clear the 
error state. 

The DEBOG facility commands are as follows. Wherever numeric values are used, 
they are always hexadecimal values without the suffixed H unless otherwise 
specified. 

X The DEBUG facility shifts to X display mode, if not already there. 
The X display contains 15 lines. The 1st through 4th lines contain the 
1st 64 byte memory area display. The 5th line displays the interrupted/ 
replaced contents of Z-80 registers AF, BC, DE and HL. The 6th through 
9th lines contain the 2nd 64 byte memory area display. The 10th line 
contains the interrupted/replaced contents of Z-80 registers AF' , BC* , DE* 
and HL*. The 11th through 14th lines contain the 3rd 64 byte memory area 
display. The 15th line contains the interrupted/replaced contents of Z-80 
registers PC, SP, IX and IY. The displays for registers AF and AF* also 
include a bit mask for the associated F register, with an alphabetic 
character if the bit equals 1 (state set) and a - if the bit equals 
(state not set). The meanings of the bits (7 - 0) are: 

7. S = minus sign 

6. Z = zero 

5. 1 = unused bit 

4. H - half-carry 

3. 1 = unused bit 

2. P = even parity or overflow 

1. N - subtraction 

0. C = carry 

Using the X display allows the user to track the registers and three Sep- 
arate memory areas at one time. 

S The DEBUG facility shifts to S display mode, if not already there, 
using X display's 1st memory area's base address rounded down to a 256 
byte page boundary as the S display's base address. The S display dis- 
plays 256 bytes of memory, using 16 display lines. 

[n]Daddrl If in S display mode, the 256 byte block containing addrl is 
displayed; if n is specified, the base address of the the specified area 
is changed, but the display won't change since DEBUG is in the S display 
mode. If in the X display mode, addrl becomes the base address for the 
specified area: 1 if n not specified, 2 if n equals 2, and 3 if n equals 
3. Examples: 

1. D7080 displays the contents of locations 7000H - 70FFH if 
DEBUG is in S display mode. If in X display mode, display area 1 
will display the contents of locations 7080H - 70BFH. 
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2. 3DFFC0 If DEBUG is in X display mode, display area 3 will display the 
contents of locations FFC0H - FFFFH. If in S mode, the new area 3 address is 
remembered, but the display is not changed. 

[n]; If in S display mode and n not specified, the S display is ad- 
vanced to the next 256 byte block. If in X display mode, the specified 64 
byte display area is advanced 64 bytes: area 1 if n not specified, area 2 
if n equals 2, and area 3 if n equals 3. 

In]- If in S display mode and n not specified, the S display is re- 
tarded to the next lower 256 byte block. If in X display mode, the spec- 
ified 64 byte display area is retarded 64 bytes: area 1 if not specified, 
area 2 if n equals 2 and area 3 if n equals 3. 

Haddrl The DEBUG facility shifts to S display mode, if not already 
there, displays the 256 byte block containing addrl , enters modify mode 
and displays a blinking cursor over the hex digit next to be changed. 
Pressing a key - 9 or A - F causes that hex digit to be replaced in 
memory and the cursor advanced one position. Pressing right arrow or 
space advances the cursor one position without memory change. Pressing 
left arrow retards the cursor one position without memory change. Pres- 
sing shift left arrow retards the cursor 4 hex digits without memory 
change, and pressing shift right arrow advances the cursor 4 hex digits 
without memory change. Pressing up arrow moves the cursor up one display 
line without memory change, and pressing down arrow moves the cursor down 
one line without memory change. The cursor cannot be advanced or retarded 
outside the current 256 byte page. Pressing ENTER terminates modifiy 
mode. Any other key terminates modify mode and raises ERROR state. 
Example: 

M6314 DEBUG is shifted to S mode, if not already there. The con- 
tents of 6300H - 63FFH are displayed, and a blinking cursor is dis- 
played over the first hexadecimal digit of byte 6314H. The operator 
may now key in replacement hexadecimal digits and/or move the cursor 
around within the displayed 256 byte page. 

F[addrl][,hbl][,hb2][,hb3]|;,hb4] Starting at main memory location 
addrl, find an occurrence of the specified series of hexadecimal bytes. 
hbl , hb2, hb3 and hb4 are each 2 hex digits representing a hexadecimal 
byte. If any of hbl, hb2, hb3 or hb4 are specified, addrl must also be 
specified. If none of hbl, hb2, hb3 or hb4 is specified, then the series 
of hexadecitoal bytes last used by an F command is used. If addrl is not 
specified, then the memory location +1 of the last F command match is 
used, thus allowing the user to find successive occurrences of the initi- 
ally specified byte string. Main memory is searched for an occurrence of 
the search string of bytes. If found, the address of the first of the 
matching bytes less 20E is made the X display's 1st area's base address. 
This causes the matching byte string to appear at the start of line 3 of 
the X display. If not found, X display's 1st area's base address is set = 
0FFE0H. Example; 

F5200, CD, 24,44 will start at main memory location 5200H and 
search for the first occurrence of the three bytes mentioned. Subse- 
quently, the command F will search for the next occurrence of the 
same three bytes. 
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If a natch takes places in the current stack area, it is possible that the 
matching bytes will be gone from the stack before they can be displayed, 
thus causing the user to think DEBUG has stopped erroneously. Further, 
DEBUG stores the comparison copy of the bytes in the 51xxH region of mem- 
ory; so if that area is searched, a match will be found upon the compare 
bytes themselves . 

I Execute the interrupted program's current instruction and then 
re-enter the DEBUG facility. This allows the user to single step execute 
the interrupted program. The user may then observe the changes (or havoc) 
wrought by each instruction. Single stepping has some pitfalls however: 

1. A full timer interrupt sequence may also execute during the single 
step. 

2. Single stepping is not allowed if the instruction location is less 
than 5200H or jumps to or returns to a location less than 5200H. 

3. The DEBUG facility uses the 2-80 instruction RST 30H to trap for 
the return to DEBUG after the single instruction has been executed. 
Therefore, the single stepped instruction should not branch upon 
itself and should not refer to the next byte following itself as the 
source or destination of data. 

C Performs identical to I except that if the single stepped instruc- 
tion is a CALL, the entire called routine is executed during the so called 
single step. 

Rdreg,valuel Replaces the interrupted contents of double register dreg 
with the value valuel. Examples: 

RDE,C000 replaces the previous contents of register DE with the 
hexadecimal value C000. 

RHL' ,7100 replaces the previous contents of register HL' with the 
hexadecimal value 7100. 

Ldnl,drBl Relative sector drsl of the diskette mounted on drive dnl is 
read into DOS's system sector buffer (Model I locations 4200H - 42FFH; 
Model III locations 4300H-43FFH). DEBUG then shifts into S mode and dis- 
plays the sector's contents in that buffer, drsl is a decimal (yes, dec- 
imal) value. The user is responsible for providing correct values for dnl 
and drsl as DEBUG makes no checks. Once the sector's contents are in the 
buffer, the user may treat those bytes as normal main memory, may search 
them using the F command and may alter them by using the M command. How- 
ever, altering the sector in the buffer does not alter it on the diskette; 
the WR command must be executed to store the sector back onto the disk- 
ette. Since almost all NEWDOS/80 system programs use the system sector 
buffer for their diskette reads and writes, the user should not use the L 
or WR commands if the interrupt took place in DOS (in this case the inter- 
rupt address is usually below 5200H hut be careful of COPY, FORMAT, etc.) 
and he/she intends to continue the interrupted program's execution. 
Warning !!! If passwords are enabled, commands L and WR will be rejected 
and ERROR state entered. Example: 

LI, 150 loads the 151st sector of the diskette currently mounted 
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on drive 1 into the system sector buffer. 

HRdnl,dxsl The contents of the system sector buffer (4200H-42FFH on the 
Model I; 4300H-43FFH on the Model III) are written to relative sector drsl 
of the diskette mounted on drive dnl . The parameter definitions and 
restrictions in the use of command L also apply to command WR. If the 
specified diskette sector is read protected, it is written read protected. 
Warning!!! If you specify the wrong values for dnl and drsl, you will 
write the buffer's data to the wrong sector and create for yourself a lot 
of trouble. Be sure you know what you are doing!!! Example: 

WR1.150 writes the current contents of the system sector buffer 
to the 151st sector of the diskette currently mounted on drive 1. 

Q Exit DEBUG to DOS READY. The previous program is forgotten. If 
the system was in DOS-CALL or MINI-DOS, that state is purged. 

G[ addrl] [,addr2][*addr3] Restore the registers and resume program 
execution. If addrl is specified, execution resumes at that location; 
otherwise it resumes at the memory address specified in the PC register. 
If addr2 is specified, a breakpoint is set for that location by replacing 
the byte at that location with the single byte Z-80 instruction RST 30H 
which when executed will cause the DEBUG facility to be reentered. The 
replaced byte is not lost (it is restored upon DEBUG re-entry), but it is 
unavailable during the period from DEBUG exit until DEBUG entry. Addr3 is 
a 2nd breakpoint address. When addr2 is specified, it is not required 
that addrl be specified. Addr2 and addr3 must not be less than 5200H. 
Examples : 

G7000, 8400, 8425 will set a breakpoint at main memory locations 
8400H and 8425H, and will restore the registers and commence program 
execution at main memory location 7000H. 

G will restore the registers and commence program execution at 
the main memory location saved in the PC register. If the inter- 
rupted program was awaiting input (such as DOS READY or BASIC READY) 
at the time of interrupt, it is still awaiting input. Even though no 
cursor is re-displayed (as DEBUG does not remember the cursor state), 
the user may proceed with key input. 



4.2. MIHI-DOS. 

There are many times when, during the execution of a main program, the operator 
would like to interrupt the main program, execute one or more of the DOS lib- 
rary commands and then resume main program execution without any change having 
occurred to the main program's state during the interruption. NEWDOS/80 pro- 
vides such a facility, called MINI-DOS. 

In order to use MINI-DOS the following conditions must be met: 
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1. SYSTEM option AB = N. 

2. SYSTEM option AF - Y. 

3. Either (1) interrupts are enabled or (2) the main program is awaiting 
keyboard input via the standard keyboard input routine and SYSTEM option 
AJ = Y. 

With these conditions satisfied, the simultaneous depression of the keys D, F 
and G will cause the main program to be interrupted, its register state saved, 
and MINI-DOS state to he entered. MINI-NEWDOS/80 READY will be displayed. 
CAUTION, pressing DFG is not recommended while disk I/O is in progress as a 
fatal error to the diskette is possible; if exit from MINI-DOS is via MDBORT, 
then there' 8 no problem. 

From MINI-DOS state, the operator may execute any of the DOS library commands 
except APPEND, CHAIN, COPY and FORMAT. Non-library commands or programs may 
not be executed under MINI-DOS. 

When ready to return to the main program, enter the DOS library command MDRET. 
If the cursor was displayed before DFG, it will be redisplayed. The main pro- 
gram's register state is restored, and the main program resumes its execution. 
If the main program was awaiting keyboard record input and a partial record was 
already inputted, that partial record is still in the buffer even though it is 
not displayed. If the main program was awaiting keyboard input, whether or not 
any characters had been entered, upon exit from MINI-DOS, the main program is 
still waiting. Don't be timid; start keying. If the main program was not 
awaiting keyboard input, it will go on about its business. 

If the main program is not to be resumed, entering the DOS library command 
MDBORT will terminate both MINI-DOS and the main program, with the system going 
to normal DOS READY. 

Though COPY may not be used under MINI-DOS, simple file copies can be done 
using DOS library command MDCOPY. 

NEWDOS/80 is unable to eliminate all cases where the triple key depression 
results in one or more of the keys being transmitted as input to the main pro- 
gram. This is especially so when system option AJ - N. These spurious keys 
usually show up on exit from MINI-DOS. The user should back space over them, 
and should not use triple key depression when the main program is in text 
overwrite mode. 

As an example of MINI-DOS use, start at DOS READY and execute the following: 

BASIC 

10 PRINT "HELLO": GOTO 10 

RUN 

The BASIC program is now in an endless loop printing the word HELLO on the 
display. Simultaneously press the D, F and G keys. The BASIC program's 
execution is interrupted, and the message MINI-NEWDOS/80 READY appears on 
the display. Now execute the following DOS commands: 
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DIR 

FREE 

CLOCK 

CLOCK, K 

LIB 

SYSTEM,!* 

PDRIVE,0 

MDRET 

The MDRET command caused the exit from MINI-DOS, and the BASIC program 
continued execution where it was interrupted. Now, while we have a test 
program executing, let's try out the entry to DEBUG. Simultaneously 
depress the 1, 2 and 3 keys. Once again, the BASIC program's execution is 
interrupted. The DEBUG routine is now active, and the display is loaded 
with either the X or the S DEBUG display format. Now type in G followed 
by ENTER. DEBUG is exited, and the BASIC program continues execution. 
Now, press DFG again to get back into MINI-DOS. Once there, execute DOS 
command MDBORT. This causes DOS to forget about the interrupted program, 
to exit MINI-DOS and go to normal DOS READY. 



4.3. CHAHIHG. 

The DOS commands CHAIN and DO are simply different spellings of the same com- 
mand; therefore, in this section, only the command word CHAIN will be used 
where in reality either one can be used. 

For most TRS-80 users there are functions which use the same series of DOS 
commands and/or program responses, and for each of these functions it would 
save a lot of key stroking, operator time and errors if this keyboard character 
sequence could be saved in a disk file to be called upon when the operator 
wishes to execute a specific function. 

For example, suppose that each time a reset/power-on is done, the operator 
keys in the following commands and program responses; 

HIMEM,0E800H Execute DOS command HIMEM 

PROGRAMl Execute program named PR0GRAM1 

Y Response to PROGRAMl's 1st query. 
50 Response to PROGRAMl's 2nd query. 
PR0GRAM2 Upon PROGRAMl's completion, execute program 

PR0GRAM2 
1 Reeponse to PR0GRAM2 r s 1st query 

W0RKF1 Response to PR0GRAM2's 2nd query 

W0RKF2 Response to PR0GRAM2's 3rd query 

BASIC, RUN"BASPGM1/BAS" Upon PR0GRAM2's completion, enter BASIC 

and run BASIC program BASPGM1. 

Y Response to BASPGMl's 1st query. 

Subsequent input to BASPGM1 is assumed to vary from run to run, is there- 
fore not part of the standard sequence and of no concern here. What is of 
concern is that this same sequence of keyboard input must be keyed in each 

time. 
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However, if this keyboard character sequence was placed in a disk file 
named, for example, XXX/JCL, then this keyboard input sequence can be 
triggered to occur by executing the DOS command: 

CHAIN , XXX/JCL 

The execution of this CHAIH command (see section 2.9) causes keyboard 
input to come from the file XXX/JCL, starting at the file beginning and 
transmitting characters as keyboard input when requested by DOS or the 
executing program. The characters are transmitted upon request until the 
end of the file is reached, at which time keyboard input is switched back 
to the normal keyboard. Thus, having keyed in the CHAIN command, the 
operator may sit back and wait until after BASPGM1 has received its first 
response instead of having to key in the various commands and responses as 
needed. 

Further, since this keyboard sequence is to be invoked at reset/power-on, 
the operator may avoid even the keying in of the CHAIN command by setting 
that command up beforehand as the AUTO command (see section 2.4). This is 
done by executing the DOS command: 

AUTO, CHAIN, XXX/JCL 

Now, when reset/ power-on is done, the CHAIN command is automatically 
executed, and the operator has nothing to do until after program BASPGM1 
has received its first response. 

Both this process of causing keyboard input to be taken from a disk file and 
the associated operational mode that NEWDOS/80 is in during that time is called 
chaining. The files that contain the keyboard character sequences are called 
chain files. 

NEWDOS/80 is not concerned with the creation of chain files; NEWDOS/80 only 
uses them in response to a CHAIN command (see section 2.9). It is up to the 
user to decide what keyboard character sequence is to be contained in a chain 
file, and it is left to the user to build the chain files he/she needs. 
Probably the simplest way is to use either SCRIPSIT or PENCIL and store the 
resulting file in ASCII mode. For users that do not have either SCRIPSIT or 
PENCIL, a BASIC program named CHAINBLD/BAS has been included on the NEWDOS/80 
diskette to create and edit simple chain files. To build chain files having 
other than printable keyboard characters, some other chain file build program 
must be used. 

Chain file creators must remember that, except for any /./ type chaining 
control records (discussed below), the chain file must contain exactly the 
keyboard character sequence that DOS or the current executing program expects. 
Chaining does not guess for you. 

During the processing of a chain file, NEWDOS/80 operates in one of two modes, 
depending upon the setting of SYSTEM option AT. 

If SYSTEM option AT = Y, then all requests for keyboard input via the 
standard keyboard routine are honored from the chain file. This applies 
to both a request for a record (such ae INPUT or LINEINPUT in BASIC) and 
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for a single character (such be INKERS in BASIC). 

If SYSTEM option AT - N, then only requests for full records (such as 
INPUT or LINEINPUT in BASIC) via the standard keyboard routine at ROM 
location 0040H are honored from the chain file. Requests for a single 
byte (such as INXEY$ in BASIC) are honored from the keyboard. 

On the NEWDOS/80 Version 2 diskette the user has been provided vith (1) the 
BASIC program CHAINBLD/BAS with which the user can build simple chain files and 
(2) a sample chain file named CHAINTST/JCL. The instructions for using 
CHAINBLD/BAS are given in section 6,6. Here, all we want to do is use 
CHAINBLD/BAS to look at the chain file CHAINT5T/JCL* With computer at DOS 
READY, enter the follow responses: 

BASIC RUN "CHAINBLD/BAS :0" start CHAINBLD/BAS executing 

2 chooses file load option 

CHAINTST/JCL:0 filespec of file to be loaded into memory 

L i list first page of chain file 

; list next page of file 



U return to edit menu 

Q . return to main menu 

5 exit from the program 

At each step* study carefully what is displayed. This chain file contains 
a' good example of commands , program responses , and chaining control re- 
cords. Don't be alaned at CHAIDlD'a 10 second initialization tiae. 
Once you have carefully studied the chain file, exit back to DOS and exe- 
cute the chain file using the DCS command: 

CHAIN, CHAINTST:0 

Since most chain character sequences are short, usually less than 10(1 char- 
acters, it is a shame to allocate a full granule of 1260 bytes for each such 
sequence. Therefore, NEWDOS/80 allows a chain file to be divided into sections 
with the keyboard character sequence making up each section preceded by a sec- 
tion identification record (see /./0 discussion below) excepting that the first 
section of a chain file need not have a section IP record. If the chain file 
section that is to be accessed by a CHAIN command is preceded by & section ID 
record, the CHAIN command must specify the section ID as well as the file. 

During chaining, when either end of file or end of section is encountered, 
NEUDOS/80 terminates chaining without notification and sets keyboard input back 
to the normal keyboard routine. This also happens if either DOS command CHNON,N 
or the chaining /./5N function (see /./ below) is executed* If the current 
program was awaiting input, the operator will have no indication of this change 
except that all activity will stop. Usually, the operator knows what will be 
the first display after chaining terminates; so he/she is ready for it. 

If s DCS recognized error occurs during chaining, chaining will be terminated 
with the message CHAINING ABORT displayed to . inform the operator. 

If the DOS command CHAIN iE executed while chaining, chaining simply forgets 
the previous file and starts chaining within the new file, which may well be 
the same file and section a a the previous one. CHAIN commands are not nested, 
and there is no RETURN function in chaining. 
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DOS -CALL is legal during chaining. 

During chaining* there are five way a to alter the sequence of keyboard 
character s. 

1 . The current executing program may decide to execute a CHAIH or CHNOH 
command via DOS -CALL (CMD"doscmd 1t in BASIC). 

2. A CHAIN command itself may be part of the chain file. However, for 
the command to be executed, either DOS must be awaiting its next command 
or the current program executing must be clever enough to detect the CHAIH 
command record in it* normal record processing and execute .the CHAIN 
command via DOS-CALL {CMD n doEcmd" in BASIC). 

3. An easier method is by having the chain file contain a /./4 type 
chaining control record (discussed below) at the point where the change of 
sequence is to occur* Using the /./ allows the chaining sequence to be 
changed regardless of whether DOS or a user program is in control and the 
sequence change takes place without notification on the display. The 
limitation of this type of sequence changes is that chaining cannot shift 
to a different file. 

4. The DOS command CHNON (see section 2.10) may be part of a chain file. 
Remember, DOS must be awaiting its next command. If CHHONjN is specified, 
chaining is deactivated (though the chain file is not closed and. file 
position is remembered for a subsequent CHNON, Y or CHNON, D command), end 
keyboard input next comes from the keyboard. If CHNON, Y is specified and 
DOS -CALL is active, chaining continues but the current DOS-CALL level is 
exited, 

5. A /./5 type chaining control record (defined below) may be used in the 
chain file instead of DOS command CHNON. The /*/5 record function is exe- 
cuted even if DOS is not awaiting its next command. 

If the CHAIN command is executed via DOS-CALL ( GMD"doscmd ,r in BASIC), the pro- 
grammer must remember that DOS remains in DOS-CALL executing DOS commands from 
the CHAIN file until either end of file, end of section , command CHNON, N or 
command CHN0N,Y (see section 2,10) is encountered. Thus, if a program wishes 
toactivate chaining but wants to process subsequent chain input itself, then 
the first characters of that chain file or chain file section must be either 
CHNON ,Y or CHNQN.N. 

Chaining has six control records that may be placed within a chain file. Each 
of these records must start with either a one character or a 4 character iden- 
tification sequence and must end with the SOL (ENTER) character* In NEWDOS/80 
Version 1, only the one character record identification was used; in Version 2, 
it is recommended that the four character record identification be used, as the 
four characters are all printable and thus visible during chain file create or 
edit. The record ID characters are not displayed during chaining. These con- 
trol records cause chaining to perform the action described for each. For each 
special record defined below, the four character record ID is given first fol- 
lowed by the alternative one character ID value. 

1. /./0 or one byte - 128 (80 hex). This identifies a section ID 
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• 



record, which must be the first record of a chain section, unless the 
first section within a file is to be unnamed. The reat of the record is 
the section's ID which 1b used to match against a CHAIN command's section 
IB, if it specifies one, or against the section ID specified in a /./4 
chain control record. Subsequent file characters until EOF or until but 
not including the next section IB record are all considered part of this 
new section* Example: 

/./fSXXXXXX identifies subsequent characters as belonging to 
chain section XXXXXX. 

2. /./I or one byte = 129 (81 hex). This causes the rest of the 
record to he displayed, and then the system waits for the user to press 
ENTER before continuing. This is a built in pause function, Example: 

/./1M0UKT WORK DISKETTE The message MOUNT WORK DISKETTE is 
displayed followed by PRESS "ENTER" WHEN READY TO CONTINUE. DOS 
then waits for the ENTER. 

3. /./2 or one byte = 130 (82 hex). The rest of the record is 
bypassed without further action. This allows the chain file creator/ 
maintainer to place comment records in the file for documentation without 
them being displayed. 

4. /./3 or one byte = 131 (83 hex). The rest of the record is 
displayed, but no pause is done. This allows the creator/maintainer to 
display to the operator what is happening. Example: 

/./3PHASE TWO COMPLETED The message PHASE TWO COMPLETED is 
displayed. BOS does not wait but instead continues processing chain 
file input. 

5. /./4 or one byte - 132 (84 he*). The rest of the record is a chain 
file section ID of 31 characters or less. The current chain file is 
searched for a chain section whose section ID matches that specified in 
the /./4 record. When found, chaining continues with the first character 
of that section. If the section is not found, END OF FILE ENCOUNTERED 
error is displayed and chaining is aborted. Example: 

/./4XXXXXX Sequential chain character processing shifts 
within the current chain file to the chain section named XXXXXX (see 
/./0 example above). 

6. /-/5 or the one byte = 133 (85 hex). The rest of the record is 
either the character Y, N or B. Using this one character parameter, a 
CHNQN function is performed. The advantage of using the /./5 function 
rather than an actual CHNOH command is that DOS does not have to he wait- 
ing for its next command. The disadvantage is that the chaining state 
change is more subtle. The /./5 function is not for the novice. 
Examples; 

1. /./5N chaining is deactivated though the file is not 
closed. 

2. /./5Y chaining remains active but the current BOS-CALL 
level j if any, is exited. 
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The novice chain file creator will find it easiest to use none of the chaining 
control records described above. As experience is gained » try using the /,/3 
record to display a comment and the /./l record to display a message and wait 
for EHTER, Next, try using /./0 records to divide a chain file into sections 
and then the /,/4 record to cause chaining to branch around within a chain 
file. 

The chain file creator /maintainor is responsible for assuring that chaining 
does not create impossible situations for the system or user programs. 

During chaining and if SYSTEM option BC = Y, the operator may terminate 
chaining by holding down the up arrow key, or the operator may force a chaining 
pause by holding the right arrow key, and may resume chaining by pressing 
ENTER* 



*♦* DOS-CALL, 

NEWDQS/80 allows any machine lauguage program to call the DOS routine at 441 9H 
(see section 3.11) to execute a DOS command or user program* This capability 
is called DOS-CALL. BASIC use* DOS-CALL to execute the CMD"doscmd" function. 

The calling program builds a DOS command in a buffer and terminates it with a 
0DH byte. With EL pointing to the command, the DOS routine at 441911 {see 
section 3.11) is called to cause DOS to execute the command after moving it to 
its own buffer and converting lover case to upper. 

If the DOS-CALL is executing a user program, DOS does not check for conflict 
between the calling program and the called program. It is the responsibility 
of both programs to avoid conflicts. An example of a user program executing 
under DOS-CALL is the execution of SUPERZAP under BASIC through the 
QuV'SUPERZAP" function. 

Furthermore, the registers cannot be used to pass parameters back and forth 
between the calling and the called programs. On entry to the called program, 
however, register EL does point to the command parameters. Also, the two bytes 
at 4403H - 4404E may be used to pass a 2 byte parameter back and forth. 

A user program activated under DOS-CALL may itself use DOS-CALL (be careful not 
to overflow the stack). DOS-CALLs can be nested, with each call activating a 
new DOS-CALL level. 

Upon return from a DOS- CALL, the calling program must check for three states. 
If Carry is set, an error has occurred that has already been displayed* If the 
program is to continue execution, then it must decide what to do. If the pro- 
gram is to terminate, it should exit via a jump to 4030H in case this program 
was itself invoked by DOS-CALL, which will cause an exit to the next higher 
calling program with C state set. 

However, if the returned state is NZ and HC, a DOS error has occurred that has 
not yet been displayed and the error code is in the right 6 bits of register A 
(bits 6 and 7 eq;ual 0). If the calling program is to continue operation, it 
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can have the error message displayed by calling 440 9H with bit 7 of register A 
- 1; otherwise it should exit via a jump to 440 9H with bit 7 of register A - 0. 
This latter action will cause the error message to be displayed and the system 
goes to DOS READY unless the calling program was itself invoked by DOS-CALL, in 
which case the error meg will not be displayed and an exit will he taken to the 
next higher calling program with register A unchanged and HC and HZ states set. 

If the returned state. is HC and Z, then the called function completed normally. 
Since all registers except AT are saved at DOS-CALL entry and restored at DOS- 
CALL exit, the only way a parameter may be passed back is by using the two 
bytes at-4403H and 4404H (17411 and 17412 decimal). Actually, the higher 
unused bytes of the DOS command buffer, 4318H r- 4367H, can be used for com- 
munication each way in DOS™ CALL, but the programmer must understand that DOS 
moves all commands into that buffer before executing them. 



4.5. JKL. 

NEWDOS/80 has a small routine for dumping the contents of the display screen to 
the priDter. This feature allows the operator to print information that would 
otherwise be lost as soon as the display is used for something else. 

Tn order to use JKL, the following conditions must be met. 

1. System option AD - Y. 

2. Either (1) interrupts are enabled or (2) the main program is awaiting 
keyboard input via the standard keyboard input routine and system option 
AJ -= Y. 

3. DOS must not be currently using its overlay area {main memory locations 
4D00H - 51FFH). 

U. DOS must not have its overlay inhibit enabled. 

With these conditions met, the simultaneous depression of the keys J, K and L 
will cause the main program to be interrupted, its state saved, and the con- 
tents of the display dumped to the printer without any editing except that 
implied by SYSTEM option AX. If the printer is not ready or drops ready, the 
system will loop waiting for it and no message will be displayed to the 
operator. 

JKL will substitute a period for each display character that is non-printable 
as defined by SYSTEM option AX, 

Pressing the BREAK key will terminate the JKL function, except if the CPU is 
hung waiting on the printer. 

When the dump is completed, the interrupted program is resumed. The problem of 
spurious input characters discussed in section 4.2 exists here as well. 

In earlier versions of MEWDOS, the JKL routine was always resident in main 
memory. In Version 2, the JKL routine was very reluctantly moved into a system 
overlay program, thus making it unusable in certain circumstances where it was 
usable before. For example, JKL can not be invoked from DEBUG. 
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4.6. Asynchronous Execution. 

NEWDOS/80, like TRBD03, allows for a very limited form of asynchronous exe- 
cution. Thia is accomplished by inserting a user interrupt routine into DOS' a 
25ms interrupt chain. The DOS routine {see section 3.8) at Model I location 
441 0H (Model HI location 447 BH) must be used to insert the routine into the 
chain, and the DOS routine 4413H (see section 3.9) must be used to take the 
routine out of the chain * Refer to these tvo sections for the required format 
of the user interrupt routine and how it ia invoked. 

Again, the user is reminded that the use of user interrupt routines under 
NEWDOS/80 is incompatible vith that under TRSDOS. 
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5. DOS HODCLES, DATA STROCTURES, AMD HISCKLLAMEODS IHFORHATIOH. 

This chapter gives information about the modules on the NEWDOS/80 diskette, 
about diskette directories and about File Control Blocks. The novice user 
should read sections 5.1 and 5.4 and leave the other sections for another time. 



5.1. Files required on each diskette used with NEVDOS/80. 

DIK/SYS 2-6 granules. Diskette directory. This file is required 
on every diskette used with NEWDOS/80 as it contains the control informa- 
tion about all files on the diskette. FORMAT or the format part of COPY 
creates this file automatically, and DOS updates this file as necessary to 
add, alter, or delete control information about files on that diskette. 
The structure of the directory is given in section 5.6. Also see section 
5.6.2 for correction to HIT sector code for D1R/SYS. 

BOOT/SYS 1 granule. Must occupy the first granule of every diskette. 
On data diskettes this file serves only to reject an attempt to boot using 
this diskette in drive 0. On system diskettes, the first sector contains 
the machine code for loading the DOS system from the drive diskette when 
a power on, reset or jump to location occurs. On NEWDOS/80 system disk- 
ettes, the 2nd sector is a duplicate of the first (required for booting on 
the Model III), and the 3rd sector contains system control information set 
up by the DOS commands SYSTEM and PDRIVE. FORMAT or the format part of 
COPY creates this file automatically. 



5.2. HEHDOS/80 DOS System Modules. 

The DOS system consists of 14 program modules which execute from three areas. 
The resident module SYS0/SYS resides in all the non-data areas from 4000H to 
4CFFH. The modules SYS1/SYS through SYS5/SYS, SYS7/SYS through SYS9/SYS and 
SYS14/SYS through SYS17/SYS all share the DOS overlay area 4D00H - 51FFH (only 
one module at a time can be in that area). SYS6/SYS executes from both the 
overlay area and the 5200H - 6FFFH area. 

SYS0/SYS 3 granules. DOS's resident module loaded by the bootstrap 
routine and remains permanently in main memory, except for the DOS ini- 
tialization routines in the overlay area which are overlaid when no longer 
needed. SYS0/SYS handles DOS initialization, disk I/O, clock interrupts, 
load of other system modules, keyboard intercept, etc. 

SYS1/SYS 1 granule. Interrogates DOS commands. 

SYS2/SYS 1 granule. Creates files, opens FCBs, allocates file space, 
allocates FDEs, encodes passwords and loads users programs to be run. 
Executor for library commands REHAME and LOAD. 
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STS3/STS 1 granule. Closes FCBs, kills files, insert/deletes entries 
from 25ms chain. Executor for library commands BLINK, BREAK, CLOCK, 
DEBUG, JKL, LCDVR, LC, VERIFY and most of PURGE. 

SYS4/SYS 1 granule. Displays DOS error messages. 

SYS 5 /SYS 1 granule. DEBUG facility. 

SYS6/SYS 7 granules. Executes in 4D00H - 6FFFH. Executor for library 
commands FORMAT, COPY and APPEND. 

SYS7/SYS 1 granule. Executor for library commands TIME, DATE, AUTO, 
ATTRIB, PROT, DUMP, HIMEM and the 1st part of PURGE, SYSTEM and PDRIVE. 



SYS8/SYS 



1 granule. Executor for library commands DIR and FREE. 



SYS9/SYS 1 granule. Executor for library commands BASIC2, BOOT, 
CHAIN, CHNON, MDCOPY, PAUSE and STMT. Enqueues and dequeues user logical 
routines and routes each invocation (see DOS routines 4461H and 4464H in 
chapter 3). 



SYS14/SYS 

and ROUTE. 

SYS15/SYS 
SYS16/SYS 
SYS17/SYS 



1 granule. Executor for CLEAR, CREATE, ERROR, LIST, PRINT 

1 granule. Executor for FORMS and SETCOM. 

1 granule. Executor for most of PDRIVE. 

1 granule. Executor for WRDIRP and most of SYSTEM. 



5.3. NEWDOS/80 BASIC Modules. 

NEWDOS/80*s Disk BASIC enhancements to the TRS-80's ROM BASIC consists of a 
main resident module and 8 overlay modules. The modules SYS10/SYS through 
SYS13/SYS and SYS21/SYS execute from DOS's overlay area, 4D00H - 51FFH. The 
modules SYS18/SYS through SYS20/SYS execute from BASIC'S overlay area, 5200H - 
56FFH. All of BASIC'S modules, except BASIC/CMD, are loaded as needed and must 
be on the system diskette when needed. 



BASIC/CMD 4 granules. Resident module residing in 5700H and up. Exe- 
cutes Disk BASIC's functions. This module need not reside on the system 
diskette as it may be invoked from a data diskette (like any other pro- 
gram), and once invoked, it is not needed again until BASIC is next 
invoked. 

SYS13/SYS 1 granule. Displays BASIC'S error messages and executes 1st 
part of RENUM. Must be on the system diskette whenever BASIC is active. 

SYS12/SYS 1 granule. Executes BASIC direct command REF. Must be on the 
system diskette if REF will be executed. 
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SYS11/SYS 1 granule. Executes BASIC direct command RENUM. Must be on 
the system diskette if RENUM will be executed. 

SYS10/SYS 1 granule. Executes BASIC statement's GET and PUT, and must 
be on the system diskette if either statement is to be executed. 

SYS18/SYS 1 granule. BASIC direct statement executor. Must be on the 
system diskette whenever BASIC is active. 

SYS19/SYS 1 granule. Executor for BASIC statements LOAD, RUN, MERGE, 
SAVE and CMD"F "DELETE. Must be on the system diskette whenever BASIC is 
active. 

SYS20/SYS 1 granule. Executor for a number of disk BASIC statements and 
usually is the module resident when BASIC is executing a program. Must be 
on the system diskette whenever BASIC is active. 

SYS21/SYS 1 granule. Executor for CMD"0" and must be on the system 
diskette if CMD"0" will be executed. 



5.4. Other Modules on the KEBDOS/80 diskette. 

DIRCEECC/CMD A program that checks the directory for errors and list or 
prints the directory contents. See section 6.4. 

EDTASM/CMD An editor/assembler for Z-80 code-source and object code 
from/to disk or tape. See section 6.5. 

DXSASSEH/CMD A program that disassembles Z— 80 machine code. See 
section 6.2. 

UfOFFSET/CMD A program that reads load modules from disk or tape and 
writes them to disk or tape. The program optionally (1) assigns new load 
addresses, (2) appends a pre-execution move-program-to-execution- location 
appendage and (3) prepares the program to run without DOS. See section 
6.3. 

SUPERZAP/CHD A program that allows inspection and modification of 
either disk or main memory. Disk operations are diskette or file 
oriented. See section 6.1. 

CHAIHTST/JCL A sample chain file created by CHAINBLD/ BAS . 

CHAIMBLD/BAS A BASIC program that creates and edits simple record 
oriented chain files for subsequent use via the DOS commands CHAIN or DO. 
See section 6.6. 

ASPOOL/HAS H. S. Gentry's automatic spooler program as modified by 

Apparat for NEWDOS/80. See section 6.7. 
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5.5. Reduced Sized Systems. 

Reduced sized syB terns can be created, if passwords are disabled, by COPYING the 
full NEWDOS/80 diskette onto a new diskette and then KILLING the unwanted 
files. A minimum system to handle open's and close's will consist of 10 gran- 
ules (BOOT, DIR, SYS0-SYS4). If the DEBUG facility is to be used (including 
BASIC'S CMD"D"), add SYS5. Section 5.2 indicates which additional modules must 
be added for the various DOS library commands. If BASIC is to be used, section 
5.3 indicates which BASIC modules must be added, and section 5.2 indicates 
which DOS modules must be added if DOS library commands are to be executed via 
BASIC'S CMD"xx" statement. 

If the system module loader finds the module's directory entry inactive or 
encounters an error during loading, then one of the following occurs: 

If SYS4 is an active module in the system, then SYSTEM PROGRAM NOT 
FOUND error will be displayed via a jump to 4409H. 

If the jump to SYS4 via 4409H finds SYS4 not in the system, then the 
Z— 80 HALT instruction is executed which on the Model I causes reset 
and on the Model III stops the computer (the operator must manually 
press reset). 

Modules included in this category are SYSl/SYS thru SYS21/SYS. If any of 
BASIC overlay modules fail load, the user must carefully execute BASIC * 
to get back the basic program text. 

CAUTION! II Once a system file has been killed from a system diskette, it can- 
not be restored by simply copying it from another system diskette. The DOS 
system loader requires that system file FPDEs be in specific FDE slots in the 
directory and that all of a system file's space be accounted for in the first 
extent element. Further, SYS0/SYS must occupy the same granules as it did 
before kill, and it is recommended for efficient system operation that all 
other system files also occupy the same granules. Once the FPDE has be pro- 
perly reconstructed, DOS command COPY can then be used to copy the file's 
contents. 



5.6. Diskette Directory Structure. 

For the Model I, NEWDOS/80 and TRSDOS diskettes are interchangeable provided 
the NEWDOS/80 diskette's directory consists of only 2 granules (see DDGA 
parameter of FORMAT, section 2.22, and COPY, section 2.14), and is set up for 
10 sectors/track, 2 granules/ lump and 5 sectors /granule operations (5 sectors 
per granule is standard for NEWDOS/80), The files on the diskettes may not be 
operationally interchangeable between the two systems; system modules, BASIC, 
ELECTRIC PENCIL, SCRIPSIT, etc., definitely are not though the files they 
manipulate are. 

For the Model III, the directories of NEWDOS/80 and TRSDOS diskettes are NOT 
compatible; a TRSDOS Model III diskette may not be used directly with NEWDOS/80 
and NEWDOS/80 diskettes may not be used directly with TRSDOS Model III. If the 
REWDOS/80 single density diskette has a directory of Model I standard position 
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and size, the Model III TRSDOS has a conversion program to copy the data to a 
Model III diskette. The COPY function of NEWDOS/80, Version 2, also has a way 
of copying one, some or all files of a Model III TRSDOS Version 1.3 or higher 
diskette to or from a NEWDOS/80 diskette (see sections 12.1 and 2.14). 

NEWDOS/80 makes all FDE's of a diskette, except those for BOOT/ SYS and DIR/SYS, 
available for use; thus, a 2 granule directory on a newly formatted data disk- 
ette has 62 FDEs available. NEWDOS/80 allows the directory to be allocated 
with up to 6 granules during diskette formatting (see DDGA parameter of PDRIVE, 
FORMAT and COPY), thereby providing for a maximum of 222 available FDEs. 

A diskette's directory always starts on a lump boundary and contains the GAT 
sector followed by the HIT sector followed by 8, 13, 18, 23 or 28 FDE sectors, 
depending upon the number of 5 sector granules allocated to the directory (see 
the DDGA parameter of PDRIVE, FORMAT and COPY). The user is encouraged to 
study the directory structure by use of program SUPERZAP (see section 6.1). 
The starting lump number of the directory is always contained as a hexadecimal 
value in the 3rd byte of each diskette's 1st sector; this value is used by DOS 
to find the directory. 

5.6.1. The GAT (Granule Allocation Table) Sector. 

The GAT sector is the first sector in the directory and contains the 
following information: 

Granule free/allocated table. Each of relative bytes 00H - 5FH 
corresponds to a lump and contains the free/allocate status bits for 
all of that lump's granules. The number of granules per lump is 
specified by the GPL parameter of PDRIVE and is a value between 2 and 
8. The lump's 1st granule's bit is bit (counting from the right), 
the 2nd granule's bit is bit 1, and so on up to the 8th granule. If 
the bit equals 0, the granule is free. If the bit equals 1, the 
granule is allocated or non-existent. 

Granule existence table. Relative bytes 60H - BFH correspond to 
relative bytes 00 - 5FH. If a bit within a byte equals 0, then the 
corresponding granule for that lump exists and is usable. If the bit 
equals 1, the corresponding granule does not exist, must not be used 
and the corresponding bit in 00 - 5FH must equal 1. Actually, though 
NEWDOS/80 creates these existence bytes during format, it does so 
only for compatibility with the old style TRSDOS diskettes (where- in 
these bytes were known as lockout bytes). Actually, NEWDOS/80 never 
sets a granule non-existent. When necessary, the granule exis- tence 
table is discarded altogether to make additional GAT sector bytes 
available to the granule free/allocated table. 

In order to maximize the amount of diskette space controlled by the 
GAT sector, NEWDOS/80 Version 2 allows the free/allocated section of 
the GAT to extend through, and thereby replace, the existence (or 
lockout) portion of the GAT. In this case, the free/allocated status 
bytes are GAT relative bytes 00H through BFH instead of 00H through 
5FH as discussed above. This extension is automatically done during 
format if the number of lumps for the diskette exceeds 60H (96 
decimal) . 
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The diskette's encoded password is in relative bytes CEH - CFH. 

The diskette name is in relative hytes D0H - D7H, 

The diskette date is in relative bytes D8H - DFH. 

If a system diskette, the AUTO command to be used at reset is 
contained in relative bytes E0H - FFH. If the first byte of this 
area is 0DH (EOL), then no AUTO command exists for this system 
diskette. 

5.6.2. The HIT (Hash code Index Table) Sector. 

The HIT sector is the 2nd sector in the directory. It serves as an index 
into the FPDEs for the diskette's files and also serves to indicate which 
FDEs are free and which are in use. If a HIT sector byte equals 0, the 
corresponding FDE either doesn't exist or is free. If a HIT sector byte 
is non-zero, the corresponding FDE is in use, and if in use as a FPDE, the 
HIT sector byte's value is a hash code formed from the contents of the 
FPDE's 6th through 16th bytes (the name and name extension). Thus, when 
it is necessary to look up a file in the directory, the hash code is 
computed and the HIT sector searched for a match. If a match is found, 
the corresponding FDE sector is read and the corresponding FPDE tested for 
matching name and name extension. If this match fails, the HIT sector 
search is continued. 

The relative position of the HIT byte within the HIT sector is exactly 
equal to the corresponding FDE's DEC code; for it is by using the DEC code 
as an index into the HIT sector that the system knows which HIT byte to 
set non-zero when a FDE is allocated and to set to zero when a FDE is 
freed. 

The HIT sector's 32nd byte is used differently in KEWDOS/80 than all the 
other HIT sector bytes. This byte contains the count of extra FDE sectors 
allocated to the directory; the legal values are 0, 5, 10, 15 and 20. 
This value is set up when the diskette is formatted. - 

On old Model I diskettes the value of the HIT sector byte for DIR/SYS (2nd 
byte of the HIT sector ) was 2CH which is not the correct value. This 
incorrect value causes FILE NOT IH DIRECTORY error to appear when the 
directory file itself is being accessed. For such diskettes, use SUPERZAP 
to put the correct value of C4H into the HIT sectbr 2nd byte. 

5.6.3. The FDE (File Directory Entry) Sectors. 

The rest of the directory's sectors are FDE sectors, with each 256 byte 
sector containing eight 32 byte FDEs. A FDE is free if bit 4 of its 1st 
byte equals and in use if the bit equals 1. An in-use FDE is a FPDE if 
bit 7 of its 1st byte equals and a FXDE if the bit equals 1. When an 
FDE is freed, only the 4th bit of the 1st byte is zeroed and the corres- 
ponding HIT sector byte is zeroed. Nothing else is changed. However, the 
user may zero the entire 32 bytes of each unused FDE by using the C func- 
tion of DIRCHECK, thus obtaining a cleaner looking directory. 
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5.7. FPDE File Primary Directory Entry. Each file, when created, is 
assigned a directory entry somewhere in the FDE sectors. This entry contains: 



1st byte: 





Bit 


7 - 


0. 






Bit 


6 - 


1 






Bit 


5 = 


0. 






Bit 


4 = 


1. 






Bit 


3 = 


1. 






Bits 2 - 


- 0. 




section 


2.3). 


2 


byte : 








Bit 


7 - 


0. 





Indicates FPDE, vice FXDE. 

If a system file. 

Undefined. 

Indicates FDE allocated to a file. 

If the file has the invisible attribute. 

Access level code (see PROT parameter of ATTRIB, 



The file may be allocated more space when necessary. 
Bit 7 = 1 prohibits this. DIR, ATTRIB, CREATE and the DOS file space 
allocation routine use this bit. 

Bit 6=0. The DOS file close function may deallocate any excess 

granules above the EOF (i.e., apparently not being used by the file). 

Bit 6 - 1 prohibits this. DIR, ATTRIB, GREATE and DOS file close use 
this bit. 

Bit 5-1. At least one sector of the file has been written to, 
either new data or updated data, since the last time this bit was set 
to 0. DIR, ATTRIB, CREATE, PROT, COPY and the DOS sector write 
routine use this bit. 

Bits 4 to 0. Undefined and reserved for future definition. 

3rd byte = 0. Currently undefined and reserved for future definition. 

4th byte. The lower order byte of the file's EOF. This value is the EOF 
position within the EOF sector. See FCB 20th byte below. 

5th byte. The logical record length (LRECL) (0 - 256) in bytes. When a 
file is created via a 4420H vector call, the value from register B is 
stored here. When an existing file is opened, even as a new output file, 
this value is not updated. This value is never used in KEWDOS/80. The 
value stored in FCB+9 at open time is that from register B, not from the 
FPDE. 

6th-13th bytes. The file name, padded on right with blanks if necessary. 

14th-16th bytes. The file name extension, padded on right with blanks as 
necessary. 

17th-18th bytes. The encode of the update password. 

19th-20th bytes. The encode of the access password. 

21st byte. The middle order byte of the EOF. 

22nd byte. The high order byte of the EOF. The 4th, 21st and 22nd 
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bytes are a 3 byte EOF value. This EOF value* instead of being in KB A 
format as are the EOF and NEXT fields of the FOB, is maintained in the old 
TRSDOS format which has the following rules: 

If the lower order byte of the EOF equals 0, the EOF is in HBA 
format. 

If the lower order EOF byte is not 0, then the EOF value in the 
FPDE is equal to the actual RBA value plus 256 (the high two 
byte value of the EOF is incremented by 1). 

NEWDOS/80 maintains the directory FPDE EOF field in this manner in 
order to maintain compatibility with the old Model 1 TRSDOS 2.3 
diskettes (see section 12.1). Hew EOF values for a file are placed 
into the FPDE only during file-create) write-EOF and DOS close. 
Thus, if the system fails requiring reset, the user can expect that 
any file open for output at the time of failure will contain the new 
data hut usually not the new EOF. 

See section 12.1 for EOF and NEXT incompatibility with other DOSs. 

23-30th bytes. Four 2 byte pairs {extent elements), each specifying a 
contiguous area of the diskette assigned to this file. The format of an 
extent element is: 

1st byte: 

255 (0FFH) means the end of the extent elements for this file. 

254 (0FEH) means the next byte contains the DEC for the first or 
next FXDE assigned to this file* 

- 253 (0 - 0FDH) equals the number of the diskette's lump in 
which the area starts* Other considerations including the 
number of lumps the GAT sector can handle limit this value to 
the range - 191. This value is also the relative location 
within the GAT sector of the byte associated with this lump. 

2nd byte (when the 1st byte is less than 254) 

left 3 bits equals the number of granules (0-7) from the start 
of the lump to the start of the area. 

right 5 bits equals the number less one of contiguous granules 
assigned to this area. 

31-32nd bytes. An extent element whose 1st byte is either 255 or 254. 
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5.8. FXDE File Extended Directory Entry. 

When a file has more than 4 space areas assigned, the additional extent 
elements are contained in FXDE's assigned to the file. The format of a FXDE 
is: 

1st byte. Bits 7 and 4 are both 1 to indicate a FXDE; all other bits 
of the byte equal 0. 

2nd byte. The DEC for previous FXDE or FPDE of this file. This is a 
backward chain. The previous entry's 31st byte will be 254, and the 32nd 
byte will contain the DEC of this FXDE. 

Bytes 3-22. Unused and should equal 0. 

Bytes 23-32. Are as defined for the FPDE. 



5.9. FCB File Control Block. Also known as a DCB (Data Control Block) 
or an 10B (input/output block). 

In order that file information be read from or written to a diskette, a link 
must be created between that file and the user program. The link is created by 
the DOS open function (see sections 3.13 and 3.14) and dissolved by the DOS 
close function (see section 3.15). During the time the link is in existence, 
the control information for that link is maintained in a 32 byte area of main 
memory known as a File Control Block. At open time, the user specifies where 
in user memory this FCB is to be. While this link is in existence, the FCB's 
area of main memory must not be used for any other purpose. DOS does not re- 
member where the FCBs are. The user informs DOS of which FCB to use for each 
function that is to use a FCB. Thus, the link is effectively dissolved by 
simply never using the FCB again in a function call or by using the FCB in the 
open of a new link. Remember though, if writing to a file where the EOF is 
being changed, either a a DOS close or DOS write-EOF (see section 3.28) func- 
tion must be done to assure the EOF is properly placed in the FPDE, 

At open time (a call to DOS 4420H or 4424H) , the caller provides in register DE 
the address of a 32 byte main memory area for use by the system as a FCB while 
the file is open. The user must have placed the filespec (terminated by a 0DH 
or 03H byte) for the desired file into the FCB's 1st bytes, and the DOS close 
function will attempt to put it back there when done. NEWDOS/80 will accept 
the Model III TR.SDOS 50 bytes area but only uses the first 32 bytes. While the 
FCB is open, the format for the 32 byte FCB is: 

1st byte: 

Bit 7=1. The link is in existence (i.e., an open has been done). 

Bit 7-0. The link is not in existence (i.e., either an open has 
not been done or a close has been subsequently done). 

Bits 6-2 = 0. Undefined. 
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Bit 1-1. The value in the FCB's NEXT and EOF fields are RBAs with- 
in the diskette, rather than the file. This allows the user to I/O 
directly to diskette sectors, bypassing the file concept altogether. 
This bit should never be 1 during byte I/O via the 0013H or 001BH 
calls. 

Bit 0=1. Sectors written to the file are written read protected in 
the same manner as DOS writes directory sectors. This hit should 
never be 1 during byte I/O via the 0013H or 001BH calls. 



2nd byte: 



Bit 7-1. Either single byte operations or logical record opera- 
tions (record length in FCB's 10th byte) are being done via this FCB. 
NEXT value is maintained at the next byte to be read or written^ 
This bit is set to 1 at open time if register B is not 0. It is also 
set to 1 whenever byte I/O is done via the 0013H or 001BH ROM calls. 

Bit 7=0. Read and write operations are by full 256 byte sectors 
with the FCB's NEXT value incremented 256 bytes upon the completion 
of each successful I/O. 

Bit 6=0. The FCB's EOF value is to be set equal to the FCB's 
resulting NEXT value on every successful write operation. 

Bit 6=1. The FCB's EOF value is to be set equal to the FCB's 
resulting NEXT value only for those successful write operations 
resulting in the NEXT value exceeding the current EOF value. 

Bit 5=0. The FCB's buffer contains the current file sector's data. 
If bit 5=1, the buffer does not contain the current file sector's 
data; if needed, that sector's data must be read into the buffer. 

Bit 4=0. The FCB's buffer does not contain updated data not yet 
sent to the file. If bit 4=1, the buffer does contain updated data 
not yet sent to the file. During DOS close, if this bit is 1, the 
sector data in the buffer is automatically written to disk. This 
updated data is also written on every 443FH and 4451H call and on 
every 4442H, 4445H, 4448H and 444EH call that positions the file 
within a different sector. * 

Bit 3=1. This FCB is in the NEWDOS/80 Version 2 format for the 
18th - 32nd bytes. This bit is set to 1 by DOS open. If bit 3=0, 
the FCB is in the old format and is illegal in NEWDOS/80 Version 2. 

Bits 2-0. Access level code (see PROT parameter of ATTB.IB, section 
2.3). 



3rd byte: 



Bits 7-5. These bits are defined the same as those in the FPDE 2nd 
byte (see section 5.7). If bit 5 equals 0, the DOS sector write 
routine sets the bit to 1 in both the FCB and the FPDE just before it 
actually writes the current sector to disk. 
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Bits 4-0. Undefined and reserved for future definition. 

4-5th bytes. The main memory address of the FCB's buffer. The user 
determines where the buffer is to be and puts this address into register 
HL before the call to the DOS open routine. Sectors are read from disk 
into this buffer and written to disk from this buffer. 

6th byte. The low order byte of the FCB's NEXT field. This is the rela- 
tive position within sector value. See discussion for FCB 12th byte 

below. 

7th byte. The relative number of the drive containing the diskette con- 
taining the file. 

8th byte. The DEC code of file's FPDE. After the FCB is opened, this DEC 
code is the link between the open FCB and the file's directory information 
as the FCB itself no longer contains the filespec. 

9th byte. The low order byte of EOF. This is the relative position 
within the EOF sector. See discussion of FCB 14th byte below. 

10th byte. The logical record length (LRECL) (0 = 256) for records of 
this file. This value is supplied in register B by the caller at open 
time. If not at open time, bit 7 of the FCB's 2nd byte is set to 1, and 
subsequent DOS sector read or write calls must contain, in register HL, 
the address of the logical record to be moved to the FCB's buffer (write) 
or filled from the FCB's buffer (read). 

11th byte. Middle order byte of the NEXT field. 

12th byte. High order byte of the NEXT field. The 12th, 11th and 5th 
bytes form a 3 byte RBA within the file of the next byte to be processed, 
either input or output. 

For single byte and logical record I/O, DOS maintains the FCB NEXT 
field in exact EBA format. 

For full sector I/O, DOS also maintains the NEXT field as an exact 
F.BA, but there are subtle actions by DOS that can give trouble if the 
user is not aware of them. DOS does not change the lower order byte 
of the NEXT field during full sector I/O. Normally, this byte is 
zero, and that's fine. However, the user can set this byte non-zero 
or if the previous I/O done was in single byte or logical record mode 
the lower order byte will probably be non-zero. The user must be 
aware of the following rules: 

During full sector reads, all three bytes of NEXT participate 
the EOF check just as for single byte and logical record reads. 

During full sector write, when the low order byte of the NEXT 
field is non-zero, the NEXT field is not advanced 256 bytes 
upon the successful completion of the write and EOF, if it is 
updated, assumes that non-advanced NEXT value. The rationale 
here is that if the NEXT field's lower order byte is zero, the 
value of NEXT after the successful write is to be at the first 



5-11 DOS MODULES 



byte of the next sector, but if the NEXT field's lower order 
byte is non-zero, the value of NEXT after the successful write 
is to remain within the sector just written. 

See section 12.1 for discussion of NEXT and EOF field incompatibility 
with other DOSs, 

13th byte. Middle byte of the EOF field. 

14th byte. The 14th, 13th and 8th bytes form 3 byte RBA within the file 
of the end-of-file (the 1st byte beyond the file's last data byte). This 
value is initialized from the FPDE at open time, and is updated at sector, 
logical record or byte write time under control of the FCB 2nd byte, bit 
6. See section 12.1 for discussion of NEXT and EOF field incompatibility 
with other DOSs. 

15-22th bytes. Identical to 23-30th bytes of FPDE. 

23-24th bytes. For the current FXDE whose 4 extent elements are in the 
FCB 25th - 32nd bytes, the number in this field represents the relative 
granule number of that FXDE's 1st extent's 1st granule. If that value 
equals 0FFFFH, then no FXDE is represented in the 25th-32th bytes. 

25-32nd bytes. Identical to 23-30th bytes of the current FXDE, if any. 

Discussion of FCB bytes 17-32: 

The definition for FCB bytes 17 to 32 has changed from what it was in 
NEWDOS/80 Version 1 and Model I TRSDOS. It was assumed that very few 
user programs ever referred to these bytes as they serve only to re- 
duce the number of directory accesses done by the resident DOS. How- 
ever, some users (such as the old SUPERZAP coded in BASIC) have made 
use of the old definitions to get around having to open a file when 
diskette, rather than file, I/O was wanted. NEWDOS/80 Versions 1 and 
2 have provided a diskette, as opposed to file, I/O method (see FCB 
1st byte, bit 1 definition); that method should be used and those old 
pseudo FCB methods MUST be discarded to run with NEWDOS/80 Version 2. 
Failure to do so could be catastrophic; NEWDOS/80 Version 2 has 
activated bit 3 of FCB 2nd byte in an attempt to head off these bad 
pseudo FCBs. 

This change to the FCB 17-32nd bytes allows the FCB to contain all of 
a file's extent information for any file having 8 or less extents 
(DIR with the A option will display how many extents a file has). If 
the file occupies contiguous diskette space, 8 extents is enough for 
approximately 300,000 bytes (or 270,000 bytes if the directory is 
spanned by the file's space). 

If the file has more than 8 extents, meaning that more than one dir- 
ectory FXDE is assigned to the file, then the FCB contains space 
information for the file's 1st 4 extents and the 1 to 4 extents of 
the FXDE last having a sector read or written. It is quite possible 
for large randomly accesssed files to require a lot more directory 
accesses than was done under NEWDOS/80, Version 1. 
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6. ADDITIONAL PROGRAMS SUPPLIED OH NEWDOS/80 DISKETTE. 

6.1. SUPERZAP. 

Program SUPERZ AP/ CMD provides the user with the means to read and write stand- 
ard 256 byte diskette sectors or any part of main memory, except writing to 
ROM. Learning to use SUPERZAP is strongly recommended for all NEWDOS/80 
owners. If corrections (known as zaps or patches) are to be made to your 
NEWDOS/80, Apparat will distribute them in written form for application using 
SUPERZAP. You must know how to us DPS and MODxx. In learning to use SUPERZAP, 
do your learning on a diskette having data that you can afford to losellll! 

Certain diskettes are written in non-standard sector formats and are thus inac- 
cessible to SUPERZAP. There exist other programs that read anything that is on 
a diskette) but do not have some of the other SUPERZAP features. The user, at 
some time, will probably want to buy one of these other programs from the ven- 
dors that sell them. 

SUPERZAP operates in both upper and lower case. 

Where numeric values are inputted and unless otherwise specified, SUPERZAP 
assumes DECIMAL unless the value is suffixed with the character H to indicate 

hexadecimal. 



6.1.1. Function Modes. The menu displays the functions available. The 
user keys in the selected function's characters and then presses ENTER. The 
SUPERZAP functions are as follows: 

DD Display a Disk sector. SUPERZAP will ask for the drive number and 
the number of the relative sector within the diskette, read the sector and 
display it. 

DM Display a 256 byte page of main memory. SUPERZAP will ask for a 
memory address, truncate it to a 256 byte boundary and display the page. 

DPS Display a File's Sector. SUPERZAP will ask for the file's file- 
spec. Next, SUPERZAP will ask for the relative sector number within the 
file and will display that sector. 

DTS Display track's sector. SUPERZAP will ask for the drive number, 
track number and the number of the relative sector on the track. It will 
then read the sector and display it. 

DMDB Display Memory Dump Block. SUPERZAP will ask for the filespec of 
the memory dump file (created by DUMP, see section 2.20). It will display 
the dump's base address. Next it will ask for a main memory address with- 
in the range of the dump, truncate it to a 256 byte boundary and display 

the memory page. 

VDS Verify Disk Sectors. SUPERZAP will ask if the operator wants a 
pause when a read protected sector is encountered. Next, SUPERZAP will 
ask for the drive number and the number of the relative sector on the 



6-1 ADDITIONAL PROGRAMS 



diskette of the 1st sector to be verified. lastly, it will ask for the 
number of sectors to be verified. It will then proceed with the verify 
which consists simply of reading each sector within the range specified. 
When a protected sector is encountered and if a pause was requested, 
SUPERZAP will display the sector's location and wait for the operator to 
press ENTER before continuing. VDS is a fast way of finding bad sectors 
on a diskette that the user suspects have gone bad. While verifying is 
being done, VDS may be cancelled by pressing up-arrow. 

ZDS Zero Disk Sectors. SUPERZAP will ask for the drive number and the 
number of 'the relative sector on the diskette of the first sector to be 
zeroed. Next, it asks for the number of sectors to be zeroed. The zero- 
ing is then done. The read protection status of each sector is not 
changed. 

CDS Copy Disk Sectors. SUPERZAP will ask for the drive number and the 
number of the relative sector on the diskette of the source (where the 
data is coming from) range's 1st sector. Next, it will ask for the same 
data for the destination (where the data is going to) range's 1st sector. 
Lastly, it will ask the number of sectors to be copied. The copy is then 
done. Destination sectors are each assigned the read protection status of 
the corresponding source sector. 

CDD Copy Disk Data. This function differs from CDS in that any string 
of diskette bytes may be copied. SUPERZAP will ask for the drive number 
and the number of the relative sector on the diskette of the sector con- 
taining the source range's 1st byte and then ask for that byte's offset 
within the sector. It will ask for the same information for the destina- 
tion range's 1st byte. Lastly, it will ask for the number of bytes (65535 
is the maximum allowed) to be copied. The copy is then done. The read 
protection status of the destination sectors is not changed. 

DPWK Display Password Encode. SUPERZAP will ask for the password, en- 
code it and display the resulting encode in hexadecimal as it would appear 
in a directory FPDE. 



Display Name/Type hashcode. SUPERZAP will ask first for the file- 
name and next for the type (name extension). It will then hash them and 
display the resulting hashcode in hexadecimal as it would appear in the 
directory HIT sector. 

EXIT End SUPERZAP and exit to 440DH (DOS READY). 

Since ZDS, CDS and CDD change diskette data, the user is first asked if he/she 
is sure this function is wanted, just in case the wrong function was keyed. 

For CDS and CDD, the copy normally proceeds in ascending byte order for both 
the source and destination. However, if the highest source byte is within the 
destination range, the copy is in descending byte order to avoid destructive 
overlap. 

All disk I/O's are done through the normal DOS sector I/O routines. Thus, if 
an error occurs, system option AM and AW I/O try counts are in effect. 

For VDS, ZDS, CDS and CDD, if a disk I/O error results, the operator will be 
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offered the choice of retrying, skipping the sector or terminating the func- 
tion. In many cases, repeated retrying will eventually work. If the error 
sector was a source sector, skip will cause the associated destination bytes to 
receive whatever happens to be in the source's buffer; this should be no 
problem as the user is faced with a reclaim job anyway. 

When SUPERZAP is waiting for a numeric value, keying an X as the value will 
cause SUPERZAP to terminate the function and return to the menu. If SUPERZAP 
is waiting for a filespec, a null parameter will terminate the function. 

When any. of DD, DM, DFS, DTS or DMDB is suffixed with ' ,P' , the sectors or 
memory pages will be printed as well as displayed. For DD,P, DFS,P or DTS,P, 
the user will be asked for the number of sectors to be printed. For DM,P or* 
DMDB,P the user will be asked for the number of bytes. If the printer is not 
ready or drops ready, SUPERZAP will loop waiting on it without operator noti- 
fication. Pressing the P key will cause printing to pause; press ENTER to con- 
tinue. Pressing the H key will terminate printing. 



6.1.2. Display Mode. For DD, DM, DFS, DTS and DMDB, while a sector or 
memory page is displayed, SUPERZAP is in the display mode and waits for a dis- 
play mode command. Except for the F and L commands, the keyed command bytes 
are not displayed and do not require termination with ESTER; the command is 
executed as soon as all characters of a display mode command have been keyed. 
The display mode commands are: 

X The current function is terminated and SUPERZAP returns to the menu. 

R Redisplay the same sector or memory page. 

+ or ; Display the next higher sector or memory page. 

Display the next lower sector or memory page. 

J Restart the same function. 

K Restart the same function, retaining the 1st parameter unchanged. 

SOOPY DD and DTS only. The current sector is to be copied to a speci- 
fied sector. SUPERZAP will ask for the destination sector's drive number 
and relative sector number. The destination sector may be the same as the 
source sector. SUPERZAP will read the destination sector and report its 
status. Then the source sector's contents are written to the destination 
sector. SCOPY is useful when a sector is found to have bad parity but, 
with the exception of a few bytes, is intact; by SCOPYing upon itself, new 
parity will be generated, and the sector can then be repaired. It is also 
useful for altering a sector's read protect status. 

When SUPERZAP is in the display mode, it has a diskette, file, main memory 
or memory dump file search capability. The match is on 1 to 4 hexadecimal 
bytes (without the suffixed H) which are represented by aa,bb,cc,dd. When 
the search finds a match, the sector or memory block containing the first 
byte of the match is displayed with a thin vertical blinking cursor to 
mark its position. That cursor will disappear as soon as a key is depres- 
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sed; however, the associated 'find* position is remembered in case the 
search is to be continued. When SUPERZAP is in display mode, the fol- 
lowing commands to perform searching may be keyed in, terminated by ENTER. 

F,aa,bb,cc,dd The 1 to 4 hexadecimal match bytes are stored, and 
the search starts at the first byte of the diskette (if DD or DTS 
mode) or file (if DFS or DMDB mode) or main memory (if DM mode). 

F f The same as above except the previously established match 
bytes are used. 

Fxx,aa,bb,cc,dd The 1 to 4 hexadecimal match bytes are stored, 
and the search starts within the current sector or block at the xxth 
relative byte where xx is a 2 digit hexadecimal number without the 
suffixed H. 

Fxx or Fxx, The same as above except the previously estab- 
lished match bytes are used. 

F The search continues at the first byte following the position 
of the first byte of the last match, and the search uses the previ- 
ously established match bytes. 

L f aa,bb,cc,dd This command is to be used instead of F,aa,bb,cc,dd 
when, in DFS mode, the file being searched is standard load module 
(i.e., SUPERZAP/CMD, LMOFFSET/CMD, etc.) and the user wants SUPERZAP 
to purge out all except actual object code bytes from the search. 
This allows a load module file search for two or more bytes without 
the imbedded loader control information interfering with the match. 
The resulting display will still contain the loader control informa- 
tion; the user must be prepared to occasionally see this control in- 
formation imbedded within the matching bytes. Usually, but not al- 
ways, this control information is 4 bytes long with the first byte 
being a hexadecimal 01. Except for purging this control information 
from the match, L,aa,bb,cc,dd works the same as F,aa,bb,cc,dd. The 
F command may be used to continue an L type search. 

L, The same as above except the previously established match 
bytes are used. 

HODxx DD, DM, DFS and DTS only. SUPERZAP enters modify mode and posi- 
tions the cursor to the first hex digit of relative byte xx (value 00H - 
FFH) of the current page or sector. 

EXIT End SUPERZAP and exit to 402DH (DOS READY). 

If an error occurs during the keying in of a display mode command, the partial 
command is ignored and the sector or block is redisplayed again. 

6.1.3. Modify Mode. SUPERZAP enters modify mode upon execution of the dis- 
play mode command MODxx. This mode allows the changing of individual bytes 
within the current disk sector or memory page. Responses while in modify mode 
are defined as follows: 
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Hexadecimal digit character K - 9 or A - F. The hex digit at the cur- 
rent cursor position is replaced by the new hex digit, and the cursor is 
advanced one position. If the cursor wraps around, an error will occur if 
the next character inputted is a hex digit character. Replacements in a 
main memory page are for real while replacements in a sector are buffered 
until the sector is written or a ' Q' command cancels the pending update. 

Space or right arrow. The cursor is advanced one position. 

Left arrow. The cursor is retarded one position. 

Shift right arrow. The cursor is advanced 4 positions. 

Shift left arrow. The cursor is retarded 4 positions. 

Down arrow. The cursor is advanced one display line. 

Dp arrow. The cursor is retarded one display line. 

ZTxx This sequence is displayed vertically in display column 7 and 
must terminate with ENTER, All hex digits from and including the cursor 
position to and including the 2nd hex digit of relative byte xx are 
zeroed. The cursor is left positioned to the 1st hex digit following 
relative byte xx, and if wrap around occurs, the next input char may not 
be a hex digit. 

RTxxjjk This command is similar to ZTxx except that each byte's 1st digit 
is replaced with the hex digit j, and each byte's 2nd digit is replaced 
with the hex digit k. 

Q For sector operations only. Modify mode is terminated, any 
changes in the buffer are discarded, and SUPERZAP returns to display mode. 



• 



For memory page operations, modify mode is terminated, and 
SUPERZAP returns to display mode. For sector operations, the operator is 
asked if he/she really wants to update the sector now. If not, SUPERZAP 
continues in modify mode. If so, the sector (with any changes) is written 
back to disk, modify mode is terminated, and SUPERZAP returns to display 
mode. 

When modify mode encounters an error, it will display 'INVALID MODIFICATION 
MODE CHAR. REPLY ■*■ TO CONTINUE'. Upon receiving * , SUPERZAP returns to 

modify mode. 



6.2. DISASSEM. 

Program DISASSEM/CMD disassembles Z-80 object code from a standard TRS-80 load 
module or from main memory. Tbe disassembled code is sent to the display or to 
the printer. Generated source text may be sent to disk and a location cross 

reference may be produced. 
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Responses to the query 'OBJECT FROM MAIN MEMORY OR DISK?' (M OR D) : 

1, nail or D Object is a disk load module. 

1. Respond to the query 'FILESPEC?' with the filespec of the load 
module to be disassembled. 

2. Respond to the query 'OFFSET OBJECT VIRTUAL ADDRESSES BY? (HEX)' 
with either null (meaning 0) or a 1 to 4 digit hexadecimal number 
(without suffixed H) which when added to the load addresses within 
the load module will give the proper address where the instructions 
being disassembled would be during normal execution of that code* 
This parameter is needed when an object module loads to one place in 
main memory, but actually executes from another. Wraparound is al- 
lowed. Example: 

If the object module loads into C000H - FFFFH but is to execute 

in 7000H - AFFFH, applying an offset of B000 will cause the 

disassembler to disassemble as if the load was actually done to 
7000H - AFFFH. 

3. Respond to the query 'VIRTUAL RESTART LOCATION? (HEX) 1 with 
either null (meaning start at the file beginning) or a 1 to 4 digit 
hexadecimal number (without the suffixed H) which is the listed loc- 
ation of any instruction of the disassembly. This allows restart of 
a large disassembly within the instruction print portion of the 
listing, and the location chosen is usually the location value for 
the first instruction on the page where printing was interrupted. 

2. M The object code is in main memory. 

1. Respond to the query "OBJECT VIRTUAL BASE ADDRESS? (HEX)' with 
the 1 to 4 digit hexadecimal location value (without suffixed H) 
where the object code is considered to execute from, whether or not 
it is actually there now. In the listing, this value will be the 
first instruction's printed location value. 

2. Respond to the query 'OBJECT REAL BASE ADDRESS (HEX)?' with null 
(meaning the real and virtual locations are the same) or with the 1 - 
4 digit hexadecimal main memory location (without suffixed H) where 
the disassembler will actually find the object code. 

Responses to the query 'ANY OPTIONS?': 

1. null No more options to be specified. 

2. PTR . The output is sent to the printer instead of the display. 

3. BFSP Bypass Full Screen Pauses. In normal operation the disas- 
sembler pauses whenever the display screen is full or whenever a break 
occurs in the sequential locations of the disassembled file. The disas- 
sembler waits for (1) ENTER to continue, (2) X to terminate the disassem- 
bly or (3) V (object from main memory only) to restart the disassembly at 
a new location. The BFSP option bypasses this pausing, causing display to 
occur as fast as the disassembly can proceed. This option is automati- 
cally invoked if option PTR is specified. 
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The remainder of the options are legal only when the object code is from disk: 

4. HCK,' The location reference table is not to be built and no 
display or listing done of it. 

5. HIP Do not print or display the disassembled instructions. 

6. STD Source To Disk The disassembled code is to be sent to 
disk in the format of an EDTASM source text file. See discussion below. 

7. FGH*=xxx First Generated Name xxx is the 3 alphabetic character 
name of the first name to be assigned during the STP action described 
below. The default name is AAA. 

8. RTD The location reference table is to be stored onto disk. 
After the reference table is built, the program will ask for the 
'REFERENCE TABLE FILESPEC? ■ . Respond with the filespec of the file to 
contain the reference table. Reference table files can be used (by a 
user-created program) to merge the reference tables of two or more 
programs. See below for file format. 

9. REA Enable listing of all types of references; this is the 
default. 

10. RE& Enable list of the specified reference type where '&' is 
one of L, P, R, S, T, U, V, W or X. Reference types are defined at the 
beginning of each location table listing. 

11. KIA Disable list of all types of references. 

12. RI6 Disable listing of the specified reference type where '&' 
is one of L, P, R, S, T, U, V, W or X. 

The disassembler operates through four phases: 

1. If object code from disk and option NCR not specified, DISASSEM dis- 
plays 'BUILDING CROSS REFERENCE TABLE' and passes through the object code 
building the location reference table. For a large disassembly this will 
take some time. If insufficient main memory for the table, the disassemb- 
ly will terminate. 

2. If RTD option specified, this phase writes the location reference 
table to disk. 

3. List disassembled instructions to display or printer. If STD speci- 
fied, the resulting text is also written to disk. On the disassembled 
instruction print lines, column 1 indicates the number of references to 
bytes of the instruction; the value is hexadecimal with blank meaning 
and F meaning 15 or more references. Column 2 indicates which bytes of 
the instruction have been referenced. If blank and column 1 non-blank, 
then only the instruction's 1st byte is referenced; otherwise the hex 
digit represents a 4 bit binary mask of which bytes, from the left, are 
referenced. 
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4. If object is from disk and NCR is not specified, the location refer- 
ence table is displayed or printed. The definitions of the reference type 
codes are given first. Then, in ascending numeric order, every referenced 
location is listed with the location of every referencing instruction. 
Suffixed to each referencing location value is the reference type code for 
the Z-80 instruction making the reference. 

If the disassembler finds something wrong with the object module, either 'DISK 
OBJECT FILE FORMAT NOT AS EXPECTED' or 'PAST END OF FILE* will be displayed and 
the disassembly will terminate. 

While the disassembled instructions are being displayed or printed, holding 
down F will cause a pause; press ENTER to continue. Holding down X will term- 
inate the disassembly. At most other times when DISASSEM is awaiting a user 
response, the disassembly may be terminated by holding down up-arrow and pres- 
sing ENTER. 

For main memory disassemblies, the operator may shift the disassembly point at 
will. When the disassembly is paused, keying V will display the query 'VIRTUAL 
RESTART LOCATION? (HEX)'. The operator responds a 1 to 4 hexadecimal digit 
value which is the main memory location where the disassembly is to restart. 

If the PTR option is specified and after all options have been specified, the 
following occurs: 

Respond to the query '# LINES PER PAGE, EXCLUDING TOP AND BOTTOM MARGINS? 
(1-255)' with the number of printable lines per page. 

Respond to the query '# LINES EACH FOR TOP AND BOTTOM MARGIN? (0-10)' 
with the number of lines the disassembler is to skip at both the top and 
bottom of each page. If 0, the disassembler does no paging action. What 
the disassembler does for top and bottom margins is completely independent 
and in addition to anything a printer driver may be doing. 

Respond ENTER to the query 'REPLY "ENTER" WHEN PRINTER AT TOP OF PAGE* 
when the printer is on and at top of page. 

Respond to the query 'HIGH ASCII CODE FOR PRINTER? (5A - 7F)' with the 2 
hexadecimal digit value (between 5AH and 7FH) for the highest printer code 
for your printer. 

The STD option causes the disassembled code to be converted into EDTASM type 
source text code. The resulting STD output (if not too large) can be loaded 
and assembled by EDTASM. The output ing of source text via the STD option works 
as follows: 

After the cross reference table build phase and the RTD phase, respond to 
the query 'ASSEMBLER SOURCE TEXT OUTPUT FILESPEC? ' with the filespec of 
the file to contain this generated source code. The file will be opened, 
and the generated text sent to it during the main disassembly phase. 

All numeric values within the disassembled code are replaced with a 3 
character alphabetic name unique to that value. The names are assigned 
arbitrarily in ascending alphabetic order with the first name assigned 
either AAA or the name specified by the FGN option* 
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If a numeric value does correspond to a disassembled location, the name 
assigned to that value is placed in the location name field of that 
location's instruction when it is sent to disk and displayed or printed. 

If a numeric value does not correspond to a disassembled location, an EQO 
statement is generated at the end of the source text to equate the name 
with the value. 

ORG statements are generated as necessary, and the END statement is 
generated as the last text statement. 

The format of the reference table file created by the RTD option is: 

1. 1 byte = C0H. Backward EOF. Ignore it. 

2. 1 or more entries of the form: 

1. 2 byte memory location value, 1st byte = low value, 2nd = high. 

2. Control byte, bits 7-0 (7 is left most): 

7-6 =11. Dummy last entry in table. Ignore all other bits and 

bytes of the entry. 

7-6 = 01. Referencee entry. Bits 5-0 = 0. The location is 
referenced by one or more of the subsequent referencer entries. 

7-6 = 00. Referencor entry. The instruction at this location 
referenced the location of the previous reference entry. Bits 
5-0 contain the referencer instruction type: ■» S, 1 = T, 2 ■ 
U, 3 = V, 4 - W, 5 - X, 8 « P, 9 = L, and 10 - R. See a 
reference listing for definitions. 



6.3. IMOFFSET. 

Program LMOFFSET/CMD reads a tape or disk load module, displays its load infor- 
mation, optionally changes the program's load area, optionally attaches an ap- 
pendage enabling the program at execution time to move itself from its load 
area to its execution area, optionally prepares the module to run under non- 
disk BASIC via SYSTEM, and stores the module onto disk or tape with a new name. 

IMOFFSET functions as follows: 

1. Reads either a tape-type assembly load module from tape or a disk-type 
assembly load module from disk. 

If from disk, LMOFFSET asks for the source filespec. 

When reading from tape, a single * will be displayed when LMOFFSET is 
ready for the tape. Do rewind (if necessary) fast forward position- 
ing (if necessary) and press PLAY. *** appears when tape read 
synchronization has completed. The character C will be displayed 
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when a bad checksum is encountered. The character P will be dis- 
played if leading extraneous data bytes encountered. The character 
I will be displayed if imbedded extraneous bytes are encountered. 

2. Displays (1) the area into which the module will load, (2) possible 
conflicts with system storage and (3) the module entry point. If an 
appendage is scheduled to be applied, the entry point will be into the 
appendage. 

3. Asks for a new load point. Reply either with a new load point or 
simply reply ENTER if satisfied with the current load point. If the user 
is simply transferring the load module without change, respond ENTER to 
the first request for a new load point and LKOFFSET will go directly to 
step 7 below. 

4. If a new load point specified, LMOFFSET asks if the appendage is to be 
suppressed. 

If the appendage is to be suppressed, the resulting module can only 
be used via the DOS library command LOAD as there is no appendage to 
move the program to its execution area and the entry point is forced 
equal to 0. The resulting output load module can be used via LOAD 
where two or more load modules are loaded into main memory and then 
stored as one load module via DOS library command DUMP. 

If the appendage is not to be suppressed, then LMOFFSET will append 
to the user program either a DOS enabled appendage or a DOS disabled 
appendage, depending on whether DOS is to be disabled or not. 

5. If a new load point was specified, LMOFFSET goes back to 3 above to 
display the resulting load information and ask for a new load point. If 
another load point is given, it cancels the one specified earlier, 
including its scheduled appendage, if any. 

6. Finally, when the response to 3 above is a null, then if a new load 
point was specified and the appendage is not suppressed, U10FFSET asks if 
DOS is to be disabled. If so, the DOS disabled appendage is selected; if 
not, the DOS enabled appendage is selected. 

7. LMOFFSET next asks if the destination is disk or tape. 

If the destination is disk, LMOFFSET asks for the filespec of the 
load module file to be created. 

If the destination is to tape, LMOFFSET asks for the tape module name 
and then which tape speed (L or H). Next it asks for ENTER when the 
tape is positioned and in record mode. 

8. The resulting load module is then written to disk or tape. If a new 
load point was specified, (1) the load address for each object code record 
is altered, (2) if the appendage was not suppressed, an extra object code 
record (the appendage) is inserted before the entry point record and the 
entry point is set to the appendage's 1st byte, and (3) the entry point is 
set to 00190 if a new load address was specified and the appendage was 
suppressed. 
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9. When the destination file write is completed or if an error or other 
type of termination occurs during step 7 or 8 above, LMOFFSET asks if the 
same module is to be written to another file (which may be the same file). 
If so, steps 7 and 8 above are repeated. 

10. When all done or if an error or other type of termination occurs while 
not in steps 7 or 8, LMOFFSET asks if another source load module is to be 
processed. If so, execution returns to step 1 above; if not, LMOFFSET 
exits back to DOS. 

The up-arrow key may be used at any time to terminate the current LMOFFSET 
function. If LMOFFSET is waiting for a response, hold down the up-arrow key 
and press ENTER. 

A module can end up with multiple appendages if the output from one LMOFFSET 
run is made the input to another, but doing this is strongly discouraged; in 
the case where one appendage is a DOS disable appendage, it must never be done. 
LMOFFSET knows nothing of a previously existing appendage appended by a revious 
execution of LMOFFSET. 

LMOFFSET does not perform any object code relocation! I ! 1 It only assigns code 
to new load locations so that DOS can load the module from disk without damage 
to DOS. 

If the source program loads into the display area (3C00H - 3FFFH) without 
overflowing it, those object code records will not have their load addresses 
modified. 

The appendage added to a module by LMOFFSET starts with 64 bytes of zeroes. 
This area is available to users to patch in special code. The load address of 
this patch area is the same as the module's resulting entry address, providing 
there is only one appendage. Z-80 code patched into this area will be the 
first executed when that program commences execution. This will be done before 
the program is moved to its execution locations and before DOS is disabled, if 
DOS is to be disabled. 

When a program is to run in any part of the DOS area, a DOS disabling appendage 
must be specified. The DOS disabling appendage causes the user program to exe- 
cute as if it was loaded from tape under the non-disk BASIC SYSTEM function. 

When the resulting user program module is executed, the action is as follows: 

For a DOS enabled appendage: 

1. Executes any user supplied code in the 64 byte patch area. 

2. Moves the main program to its execution locations. 

3. Commences execution of the main program. 
For a DOS disable appendage: 

1. Executes any user supplied code in the 64 byte patch area. 

2. Moves the display screen contents to high memory. 
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3. Displays the following: 

RECORD AND THEN PERFORM THE FOLLOWING INSTRUCTIONS 

1. HOLD DOWN BREAK KEY AND PRESS RESET TO ACTIVATE NON-DISK 
BASIC. 

2. RELEASE BREAK KEY AND ENTER BASIC INITIALIZATION RESPONSES. 

3. ENTER "SYSTEM". 

4. ENTER "." 

3. When the operator has done the above, the appendage continues 
execution. 

4. Restores the screen contents from high memory. 

5. Moves the main program to its execution locations. 

6. Commences execution of the main program. 



6.4. DIRCHECK. 

The DIRCHECK/ CMD module tests and lists the target diskette's directory. If 
errors are found in checking the directory, they are listed before the direc- 
tory listing. DIRCHECK also allows the option of cleaning up (not repairing) 
the directory, and, as an aid to moving single density diskettes back and forth 
between the Models I and III under NEWDOS/80, allows the option of writing the 
directory protected. 

To the query 'OUTPUT TO PRINTER', reply Y if output to go to printer and N if 
to go to the display. 

To the query 'WHICH DRIVE CONTAINS TARGET DISKETTE', reply the target drive 
number, in decimal. 

DIRCHECK reads the BOOT sector (the diskette's 1st sector), and tests that the 
first 2 bytes are 00H and FEH respectively. If they are, DIRCHECK uses the 3rd 
byte as the number of the lump at whose first sector the directory starts. If 
the first 2 bytes are not correct, DIRCHECK displays '***** DISKETTE 1ST SECTOR 
NOT "BOOT". ASSUMING DIRECTORY STARTS ON LUMP 17 DECIMAL. ' . 

DIRCHECK proceeds to read the directory. In previous NEWDOS versions, DIRCHECK 
refused to process a directory that was not write protected. Because of the 
problem of moving single density diskettes between the Model I and Model III 
under NEWDOS/80, an unprotected directory will now be accepted, with two error 
messages displayed, one at this time and one after the files have been listed. 
The error message is ****** AT LEAST ONE DIRECTORY SECTOR UNPROTECTED'. If 
this message appears along with many other errors, the user can assume that 
DIRCHECK has not found the directory and should NOT execute the W function de- 
scribed later. 

DIRCHECK uses the drive's PDRIVE (see section 2.37) data to determine the 
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number of lumps and granules accounted for by the directory. If the PDRIVE 
data is not correct for the diskette, it is very probable DIRCHECK will list 
errors that are not actually present. 

Complaints, if any, about the directory are next listed. If a number is given, 
it is in hexadecimal for use in directory repair via SUPERZAP. Do not try to 
repair a bad directory unless you know what you are doingtltlttt The next beet 
thing is to try to extract valued files via COPY and then re-format the disk- 
ette having the bad directory. 

If the complaint is about a directory entry for a file, either the primary or 
an extended entry, the hexadecimal code is the DEC for the file's FPDE. When 
the complaint deals with a file extended directory entry but does not specify 
the file name/type, the hexadecimal code is the DEC for the FXDE itBelf. When 
the complaint deals with a Hit sector byte, the hexadecimal code is the rela- 
tive location of that byte in the HIT sector. When the complaint deals with a 
GAT sector byte, the hexadecimal code is the relative location of that byte in 
the GAT sector. When the complaint deals with a granule, the hexadecimal value 
is expressed in bb,r format where bb is both the lump number and the relative 
byte location of the lump's byte within the GAT sector and x is both the rela- 
tive granule within the lump and the bit number, counting from zero from the 
right, within that GAT byte. 

The diskette's name and date are next listed. 

The files are next listed, with numeric values in decimal and the following 
definitions : 

5 System file. 

I File has invisible attribute. 

P"nnn File has access level nnn, and both update and access 

passwords are non-blank. 

EOF=sss/bbb End Of File value, sss = the relative sector within the 
file, bbb = the relative byte within the sector. 

nnn EXTS nnn is the number of extent elements, maximum of four per 
FDE, used to account for this file's disk space. 

nnn SECTORS The number of sectors allocated to this file. 

Lastly, the number of free granules and locked out granules for the diskette 
are displayed. If the diskette contains more than 60H (96 decimal) lumps or if 
GAT relative byte 60H equals 0FFH, DIRCHECK assumes that there is no lock-out 
(existence) table. Note, NEWDOS/80 does not mark granules as locked out; the 
lockout table is maintained only for compatibility with Model I TRSDOS. 

If at least one directory sector is unprotected, another error message indi- 
cating such is displayed. 

'FUNCTION COMPLETED' message is displayed followed by the query: 
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REPLY 

N TO EXIT PROGRAM 

Y IF ANOTHER DISKETTE FOR SAME SPECS 
I FOR PROGRAM RE-INITIALIZATION 

W TO WRITE DIRECTORY SECTORS PROTECTED 
C TO CLEAN UP (NOT REPAIR) THE DIRECTORY 

Reply with one of the following: 

H Program exits to DOS at 402DH. 

Y Another diskette to be checked but with same response to the printer 
query , 

I Another diskette to be checked but with different response to the 
printer query. 

W The directory sectors are read and re-written in protected state* 
Refer to specifications for DOS command WBDIRP (section 2.49) and option 
SYSTEM option BN (section 2.46). This function is only meaningful for 
single density diskettes that are going from Model I to Model III or vice 
versa or used interchangeably. 

C All unused FDEs within the directory are zeroed. This is a cosmetic 
function only that clears out residual information from no longer used 
FDEs. Normally, when DOS releases FDEs via KILL or automatic space deal- 
location, it only zeroes bit 4 of the first byte of the FDE, leaving the 
rest of the information for the remote possibility that the sophisticated 
user will attempt to reclaim the file or the sectors it used to own. 

During display or printing, pressing: 

BREAK - processing will pause at end of current line or line group. 

ESTER - continues processing. 

DP-ARROH - terminates displaying or printing. 



6.5. EDTASH Disk Oriented Editor/ Assembler. 

35 months ago Apparat converted the TRS-80's tape oriented editor/ assembler to: 

1. Read text from disk as well as cassette. 

2. Write text and/or object to disk as well as cassette. Disk files are 
validity read after all sectors written. 

3. Allow down-arrow scrolling to display up to 15 text lines. 

4. Prevent the confusing printer output associated with DEFM. Only the 
1st byte of associated object code is listed. 

5* List symbols in alphabetical order with reference list. 
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6. Accept and convert lower case alpha to upper. 

It was anticipated that Radio Shack would soon come out with a disk oriented 
editor/ assembler that would eliminate any need for the Apparat enhancements. 
To a degree that has come to pass, but not sufficiently to bury the Apparat 
enhanced version. Since the Apparat enhanced version is based on the copy- 
righted tape editor/assembler, Apparat has always required and still requires, 
as a pre-condition of use of its enhanced version, that the user purchase a 
copy of the TRS-80 tape editor/assembler and thereby pay the royalty due. In 
an effort to enforce this* Apparat has always refused, and will continue to 
refuse, to supply any documentation for the editor/assembler beyond that deal- 
ing explicitly with Apparat' s enhancements. 

This EDTASM is essentially the same as that offered with NEWDOS/21 and 
NEWDOS/80 Version 1 except: 

1. EDTASM will now display, as part of the 'A' CMD, after the TOTAL 
ERRORS display j the number of bytes left in the text area so the user can 
judge his approach to symbol table overflow or text buffer overflow. 

2. (Model III only) Object code cannot be outputted to tape. The user 
must output the object code to disk and then use LMOFFSET to copy it to 
tape. 

Supplemental instructions for the editor-assembler. 

1. To load a text module into the text buffer, enter one of the following 

commands! 

1, 1 D=fileepecl if text from disk 

2. L T=nnnnnn if text from cassette 

where f ilespecl is the filespec for the assembler text module to be 
loaded into the text buffer from disk and nnnnnn is the name of the 
assembler text module to be loaded into the text buffer from tape. 
Examples : 

1. L D=0LDTEXT/SRC:1 loads the assembler text file 
OLDTEXT/SRC into the text buffer from the diskette currently 
mounted on drive 1. 

2. L T=OLDTXT loads the assembler text file OLDTXT into 
the text buffer from tape. 

If the text buffer already contains text, the query 'TEXT IN BUFFER. 
ARE YOU CONCATENATING???' appears. If you are not concatenating, re- 
ply N; the buffer is marked empty before loading the specified text 
module. If you are concatenating, reply Y to cause the new text to 
be appended onto the end of the old. No concern is shown for over- 
lapping sequence numbers; therefore you should execute a N EDTASM 
command upon completion of the load to assure a valid set of ascend- 
ing sequence numbers. 

2. To store a text module: 
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1. W D«=filespec2 if text going to disk 

2. W T=nnnnnn if text going to cassette 

where filespec 2 ie the filespec of the disk file to receive the 
assembler text from the buffer and nnnnnn is the one to six character 
name given to the text file written to tape. Examples: 

1. W D=NEWTEXT/SRC:1 The assembler text (not the object 
code) currently in the text buffer is written to file 
NEWTEXT/SRC on the current diskette mounted on drive 1. 

2. W T-NEWTXT The assembler text currently in the text 
buffer is written to tape and named HEWTXT. 

3. For A commands with NO option not specified, respond to the query 
'OBJECT FILE TO DISK OR TAPE? REPLY D OR T?' : 

1. T (Model I only) Object code going to cassette. The program 
name will come from the A command. 

2. D Object code going to disk. Respond to the query 'OBJECT 
FILESPEC?' with the nnnnnnnn/ttt.pppppppprd filespec of the object 
module. The file will be opened immediately, but not written until 
end of assembly listing. The name in the A command is ignored. 

4. When an output text or object disk file is opened, one of the 
following is displayed: 

1. 'FILE ALREADY EXISTS. USE IT????'. Reply Y if this is your 
intention. Otherwise reply BREAK to terminate the W or A command. 

2, **************** file MON-EXISTENT. REPLY 'C TO CREATE IT'. 
Reply C if this is your intention. Otherwise reply BREAK to 
terminate the W or A command. 

5. Due to an error in the original DOS, EDTASM runs with interrupts 
disabled (except when re-enabled by disk I/O) in order that use of BREAK 
will function properly, 

6. This EDTASM can execute in a regular TRSDOS Model I environment. 

7. This EDTASM uses the standard keyboard, display and printer routines 
and control blocks. Users altering the system beware! Ill 



6.6. CHAIBBLD. 

The BASIC program CHAIKBLD/BAS is a simple program to allow users to create and 
modify chain files (chaining is discussed in section 4.3). 

CHAINBLD operates in record mode, requiring that an EOL character (ENTER char- 
acter) appear in the file at least every 240 bytes, and it treats each occur- 
ence of the EOL character as both the end of a BASIC input line and the end of 
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a record within a chain file. All inserts, deletions, replacements, moves and 
copies are done in terms of records. 

Furthermore, CHAINBLD makes no provision (except for the old Version 1 hex 
codes 80 - 83) for the file to contain special non-printable characters. The 
rule is that if the string resulting from the BASIC statement LINEIHPUT C$ 
does not contain a given character, then that character cannot become part of 
the chain file. The exception is the EOL character which is automatically 
supplied by CHAINBLD. If the user needs special characters in his/her chain 
file, some other program must be used to build the chain file. As a last 
resort, there is always SUPERZAP. 

The CHAIKBLD program starts off with a 16 second initialization period while it 
allocates maximum space to the string area. Users are warned that if BREAK is 
used to interrupt or terminate the CHAIKBLD program, they must remember that 
all available space has been assigned to the string area and that due to this 
lack of space, some functions will not work. If a CLEAR is done to free up 
some space, be sure to specify a string area size. 

After initialization, the main menu is displayed (not to be confused with the 
edit menu). The choices are: 

1. DELETE ALL TEXT LINES All the text lines in the string area are 
deleted and the edit menu is displayed. When CHAINBLD starts execution, 
there are no text lines in the string area. 

2. LOAD EXISTING TEXT FROM DISK Use this option to edit an existing 
chain file. If the string area already contains text lines, CHAINBLD will 
ask if those lines are to be deleted. If not, CHAIKBLD returns to the 
main menu as it assumes the user wants to do more with the previous text. 
Otherwise the old text lines are deleted. 

CHAINBLD will then ask for the existing chain file's filespec* If the 
f ilespec does not contain a name extension, the name extension JCL is 
assumed. The file is then loaded into the string area. The file cannot 
exceed the string area capacity and cannot have more than 1000 lines. The 
file must be segmented into records as discussed above. After the load, 
CHAINBLD displays the edit menu. 

3. SAVE TEXT TO DISK The user has completed the creation and/ or edit- 
ing of the chain file text and now wants to write it to disk. If there 
are no text lines, the CHAINBLD will ask if a null file is to be written; 
if not, CHAINBLD goes back to the main menu. 

Next, CHAINBLD asks if the file is to be written so that it can be pro- 
cessed by NEWDOS/80 Version 1. If so, any /./0 through /./3 chain control 
records are changed as they are outputted by substituting the corres- 
ponding single byte control code (80E - 83H) in place of the /./x 
character sequence. The text in the string area is not changed. 

CHAINBLD then asks for the output file filespec. If the filespec does not 
contain a name extension, the name extension JCL is used. The file is 
then written to disk. When done, CHAINBLD goes back to the main menu. 

A. EDIT TEXT This option does nothing except display the edit menu. 
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5. EXIT PROGRAM If the string area contains text that has not yet been 
written to disk, CHAIHBLD asks if the user really wants to exit the pro- 
gram; if not, CHAIHBLD goes back to the main menu. Otherwise CHAIHBLD de- 
letes all text lines and releases all string space except 50 bytes* The 
program then ends in the normal manner. 

When the edit menu is displayed the user has a number of choices: 

1. List text lines. The text lines are implicitly numbered in sequential 
order regardless of the changes that take place in the text. Line numbers 
do not belong to individual text lines. Instead a line number indicates 
the line's position at the current time within the file. This means that 
insert, delete, copy and move all change the line numbers of some or all 
of the text lines. The L and ; edit commands allow the user to dis- 
play the text lines. L; displays the first line. L/ displays the last. 
L52 displays the 52nd line. In each case, if any text lines follow the 
target line in the text, they are also displayed. The ; edit command 
allows forward text paging. 

2. The I edit command allows for a one or more text lines to be inser- 
ted in the text after the specified line. 10 does inserting at the start 
of the text. 1/ does inserting at the end of the text. 123 does in- 
serting after line 23. Lines are inserted into the text until, but not 
including, a line containing the /.// character sequence is encountered. 
That character sequence terminates the line insert mode. 

3. The R edit command allows a new line to replace an old line. R43 
causes text line 43 to be replaced with the new line that CHAIHBLD will 
ask for. 

4. The D edit command allows one or more text lines to be deleted. D34 
deletes text line 34. D 20 41 deletes text lines 20 through 41. 

5. The X edit command allows the specified text line to be added onto. 
Note that CHAIHBLD does not actually allow a line to be edited. The edit 
mode really refers to editing the entire text. 

6. The C edit command allows the specified lines to be duplicated to 
another part of the text. C 20 30 5 causes a copy of text lines 20 
through 30 to be inserted after text line 5. Please note that the old 
lines 20 through 40 will now have line numbers 31 through 42. 

7. The M edit command allows the specified lines to be moved to another 
position in the text. M 20 30 5 causes the text lines 20 through 30 to 
be deleted from the text and reinserted after text line 5. 

8. The U edit command redisplays the edit menu. 

9. The Q edit command redisplays the main menu. 

The best way to learn CHAIHBLD is to use it. The KEtfDOS/80 distribution 
diskette comes with a sample chain file named CHAIHTST/JCL. Load it in and 
look at it. Once in the string area, you may modify the text as desired, but 
do not store it back out as CHAIHTST/JCL; use some Other name. 
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6.7. ASPOOL. 

1. The object module ASPOOL contained on the NEWDOS/80 diskette is H. S. 
Gentry's automatic Spooler Program, modified by Apparat to operate with 
NEWDOS/80 and to self-relocate. This program will automatically direct your 
printer output to the disk, and then automatically print it on the printer. 
This spooler program will print in the background while your foreground main 
program is executing provided the main program every second or so either sends 
a byte to be spooled or checks the keyboard for a new input character. 

This spooler program is included on the NEWDOS/80 diskette as a free program to 
NEWDOS/80 owners. It is NOT a fully supported part of NEWDOS/80. 

The basic operation of HEWDOS/80 DOS assumes that output that DOS sends to the 
printer will not involve disk I/O enroute to the printer. Therefore, the 
spooler discards all printer output it senses coming from DOS (such as PRINT, 
JKL, DIR with P option) with the warning message CAN'T SPOOL FROM DOS being 
displayed once for each spooled file. 

This spooler program does NOT allow a spool file to be printed multiple times; 
once printed, the file EOF is set to and the file closed to reclaim the file 
space. This spooler program does NOT remember spool contents from one spool 
activation to the next (this includes a reset). The user is warned that while 
the spooler is active, do NOT use reset or DOS library command BOOT to get to 
DOS ready. Instead, if another way is not available, use DFG to get to MINI- 
DOS and then DOS library command MDBORT to get to DOS READY or use '123' to get 
to the DEBUG facility and then use DEBUG command Q to get to DOS READY. 

2. INITIAL SETUP. Create a working spool module. 

Before the spool system can be used, working program module copy(s) of ASPOOL 
must be set up. You should set up a working program module for each different 
configuration you intend to use. When making a working program module, the 
input module 'filespecl' must ALWAYS be ASPOOL/MAS or a copy of it, and the 
output module 'filespec2' must NEVER be ASPOOL/MAS. To create a working spool 
program module (as opposed to the master), enter the DOS command filespecl, I 
(example: ASPOOL/MAS: 0,1 ). The program will then ask for parameter specifi- 
cations : 

The program asks if the software printer driver whose address in is 4026H 
- 4027H at the time of spooler activation is to be used to drive the 
printer. Reply Y for yes or N for no (the spooler will drive the 
printer). If N, then: 

The program asks if the printer is parallel or serial. Answer P for 
parallel or S for serial. If serial, then: 

The program asks if the printer is an HI 4 type. Respond Y for 
yes and N for no. 

The program asks if the printer output is to be formed into pages with a 
form feed between pages. Reply Y for yes and N for no. If Y, then: 
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The user will be asked for the number of print lines per page. Enter 
a number between 10 and 99. 

The program asks if the printer uses a soft or hard form feed. A soft 
form feed is done by counting the number of lines printed and then print- 
ing carriage returns (0DH) (with or without line feeds <0AH)) until the 
end of the page is reached. A hard form feed is a single control char- 
acter that causes a form feed function. If your printer will recognize a 
hard form feed answer H, otherwise answer 3. If soft form, then: 

The program asks for the total number of lines per page. Answer with 
a number between 10 and 99. 

The program asks if a form feed is to be done at the end of each print 
file. Reply Y for yes and H for no. 

The next question concerns automatic linefeed on each carriage return. 
Some printers linefeed on carriage returns and the computer should not 
output linefeeds. If your printer is of this type (Radio Shack standard) 
answer the question with H. If you want the software to generate line- 
feeds then answer with Y. 

The program asks for the number of the disk drive that will be used to 
spool the print data. Answer with a number from to 3. 

The program asks for the number of seconds to transpire after the last 

keyboard key inputted until the spool program can start printing again. 

Respond with a 2 digit value 00 - 59. The purpose of a non-zero delay is 

to allow the keyboard to have primacy over the printer. When a keyboard 

key is depressed and if the spool program is printing a file, printer 
action will pause while keys are being inputted and until the required 
number of seconds have passed since the last key. 

The program asks if the printer is to be driven by the timer interrupts 
(every 25ms on the Model I; every 33 or 25ms on the Model III) as well as 
via keyboard input and spooler output. Reply Y for yes if the interrupts 
are to be used; reply N for no. Allowing the interrupts to be used en- 
ables the spooler program to print while a foreground program is executing 
that does not frequently check the keyboard or send output to the spooler. 
The disadvantage of using the interrupts is that for a buffered printer, 
interrupts are disabled during the entire outputting of a line to the 
printer. However, the time delay will probably be no worse than that 
associated with disk I/O. If the interrupts are used, printing will 
nevertheless stop if the foreground program never sends anything to the 
spooler or tests the keyboard for input. This is because the disk I/O to 
read the next sector is done only during keyboard checking or main program 
output to the spooler. See circular buffer discussion for an additional 
disadvantage when the interrupts are used. 

The program asks if the circular buffer is to be used to buffer keyboard 
input characters. Reply Y if yes; 8 if no. The circular buffer helps 
prevent lost keyboard input. If the 25ms interrupt is enabled to drive 
the printer (see above option), the circular buffer uses the ROM keyboard 
character input routine and therefore disables any drivers (such as 
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NEWDOS/80's keyboard intercept routine, lower case driver, etc.) activated 
before tbe spooler is activated. If the 25ms interrupt is not used to 
send spooled output to the printer, then that does not frequently check 
the keyboard or send output to the spooler. The disadvantage of using the 
interrupts is that, for a buffered printer, interrupts are disabled during 
the entire output ting of a line to the printer. However, the time delay 
will probably be no worse than that associated with disk I/O. If the 
interrupts are used, printing will nevertheless stop if the foreground 
program never sends anything to the spooler or tests the keyboard for 
input. This is because the disk I/O to read the next sector is done only 
during keyboard checking or main program output to the spooler. See cir- 
cular buffer discussion for an additional disadvantage when the interrupts 
are used. 

The program asks if the circular buffer is to be used to buffer keyboard 
input characters. Reply Y if yes; N if no. The circular buffer helps 
prevent lost keyboard input. If the 25ms interrupt is enabled to drive 
the printer (see above option), the circular buffer uses the ROM keyboard 
character input routine and therefore disables any drivers (such as 
NEWDOS/80's keyboard intercept routine, lower case driver, etc.) activated 
before the spooler is activated. If the 25ms interrupt is not used to 
send spooled output to the printer, then the regular keyboard routine(s) 
(as existed in the 4016H - 4017H vector at spool activation) is used. 
This latter also holds if the circular buffer is not used, regardless of 
whether or not the 25ms interrupt is used. 

Now that the spooler has all the initialization parameters, the in-main-memory 
program is altered. The program then asks for the filespec of the working 
program module to be stored on disk. Respond with the filespec you will use in 
the filespec2,A DOS command discussed below; do NOT respond ASPOOL/MAS ! I ! I II 
The working program module will be written to disk, and the spool program exits 
to DOS via 402DH. 



3. ACTIVATE SPOOLING. 

When spooling is to be used, enter the DOS command "filespec2,A" (example: 
SPOOLER, A ) where filespec2 is the filespec of one of the working spool program 
modules you have created. filespec2 must NEVER be ASPOOL/MAS. If the spooler 
is already active, 'FILE ALREADY EXISTS' error message is displayed. 

The module will load into the 5200H - 5FFFH region, relocate itself to HIMEM- 
areasizel+1, and sets HIKEM = HIMEM-areasizel where HIMEM is the DOS high mem- 
ory address contained in Model I locations 4049H - 404AH (Model III locations 
4411H - 441 2H) and areasizel is the amount of memory required by the spooler. 
Then the keyboard vector at 4016H - 4017H and the printer vector at 4026H - 
4027H are intercepted to vector to the spooler. If interrupts are to be used, 
a routine is entered into NEWDOS/80's 25ms interrupt chain of user interrupt 
routines. 'SPOOLER ACTIVE' is displayed, and the 402DH exit is taken to DOS. 

The spooler is now active. All data intended for the printer will be directed 
to one of five disk files (POOLl, P00L2, P00L3 , P00L4, POOLS). Why five files 
you may ask? Well, when you have "printed" as much data as you wish and would 
like that data to be actually printed on the real printer, you send an end-of- 
file to ASPOOL. This is done either via DOS command *ASP,W (CMD"*ASP,W" from 
BASIC) or by outputting to the spooler a 03 byte in the normal print stream 
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(LPRINT CHR$(3) from BASIC ). The file that was spooling will be closed and 
scheduled for printing. You may now spool to another file by just "printing" 
more data. The data will be placed on the disk while the first data file is 
being printed. This procedure may be repeated five times. If you try to spool 
a sixth file before the first has been printed on the real printer, the system 
will display 'SPOOL FULL. WAITING OK PRIKTER' and will hang until a file is 
printed. All data is printed on the real printer in the background while the 
current or another main main task is executing or simply while the system is 
waiting for the user to tell it what to do next. Whenever *ASP,W is executed 
or a 03 byte is seen in the output to the spooler, the spooler program con- 
siders this an end of file (performing top-of-form if specified) even though 
you may be sectioning your spooled output for one report to keep the printer 
going and avoid running out of space. 

Warningll! The Model III ROM routine, normally used by the spooler, will dis- 
card the current character being sent to the printer if it senses the printer 
is not ready (including busy) and the BREAK key is pressed. Since the execut- 
ing foreground program may be using the BREAK key while the spooler is printing 
in the background, there will be times when printer characters will be lost, 
unknown to the spooler. This can serious limit the usefulness of any spooler 
on the Model III that uses the ROM printer driver routine. 

You may bring the spool system down gracefully at any time by the DOS command 
*ASF,S <CMD"*ASP,S" from BASIC) or by sending a 04 byte in the normal output 
to the spooler (LPRINT CHR$(4) from BASIC). This procedure will purge the 
current spool file, will prevent any new files from being created, and will 
display 'SPOOL STOPPING'. Main program execution then continues, any charac- 
ters sent to the spooler will be ignored and the spooler continues to print any 
files that have been scheduled. When all files have been printed, the *ASP,P 
function is performed. NOTE, if the spooler appears to hang, it is probably 
waiting for the main program to check the keyboard. If the main program can't 
do this, try DFG, but wait till the drives stop. 

You may bring the spool system down abruptly at any time by entering DOS com- 
mand *ASP,P (CMD"*ASP,P" from BASIC). All remaining spooled data is lost. If 
an interrupt routine was active, it is purged. The keyboard and printer 
vectors are restored to what values they were when the spooler activated. If 
DOS's HIMEM value is the same as that set by the spooler when activated, HIMEM 
is set back to what it was before the spooler was activated, thus reclaiming 
the spooler's main memory. However, it the HIMEM is not the same, HIMEM is not 
changed, and the spooler memory remains lost to subsequent main programs. 
'SPOOLER PURGED' is displayed, and the DOS 402DH exit taken to DOS. 

You may flush the print queue at any time by entering DOS command *ASP,C 
(CMD"*ASP,C" from BASIC). The spooler will respond with "CLEAR BACKLOG OR 
PRINT (B/P)?". Respond with a B and Enter if you wish to clear the backlog, or 
a P and Enter to stop printing the current print file. Clearing the backlog 
does not purge the current print file, and clearing the current print file does 
not purge the backlog. 

The status of the spool system may be determined at any time by entering the 
DOS command *ASP (CMD"*ASP" from BASIC). The system will print a list of all 
files waiting to be printed (BACKLOG) and any file that is open for printing or 
spooling. If the system has been stopped but not yet purged, "SPOOL STOPPING" 
will be displayed. If the spooler has been purged or not activated, 'FILE NOT 
IN DIRECTORY' is displayed. 
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7. DISK BASIC, NON-I/O ENHABCEMEHTS. 



7.1. For NEWDOS/80 most, but by no means all, of the interface specifications 
between BASIC and the BASIC programmer remain the same as for DISK BASIC under 
TRSDOS 2.3 on the Model I and for TRSDOS 1.3 on the Model III. The NEWDOS/80 
BASIC user is expected to have and be knowledgeable of both the non disk BASIC 
manual and the disk BASIC portions of the TRSDOS manual for whichever of the 
two TRS-80 models is being used. The current and next chapters of this 
NEWDOS/80 version 2 documentation discuss only the differences from the TRS 
versions. Both the Tandy manuals are excellent; if they didn't come with your 
TRS-80 when you bought it, buy them!!!! Apparat does not, in this manual, 
duplicate their contents. 



7.2. General Consents 



1. When a BASIC syntax error occurs, BASIC does not automatically enter 
EDIT on the offending text line, but it does set that line as the current 
line. If the operator wishes to edit the line, press comma. This change 
is to make it more difficult for the operator to inadvertently clear vari- 
ables that he/she would otherwise want to see to assist in debugging* 

2. BASIC programs may disable the BREAK key via CMD"BREAK,R", and reen- 
able it by CMD M BREAK,Y". 



3. Because CLOAD does a NEW function between consecutive bytes from tape, 
it will lose synchronization if BASIC is running with more than 3 file 
areas. 



4. When a DOS error is encountered by BASIC and if no ON-ERROR routine is 
active, both the DOS error message and the BASIC error message are dis- 
played. 



5. BASIC now has a total of 8 overlays that it uses. The user will 
notice that disk I/O occurs whenever RUN is executed and whenever exe- 
cution is interrupted (STOP, error or BREAK) or terminated (END); this is 
done to bring in BASIC routines needed for the current or anticipated next 
function. 



6. NEWDOS/80 DISK BASIC does NOT allow text line deletion to be done by 
simply typing in the line number. The explicit delete command, DELETE or 
D, must be used. 



7-1 DISK BASIC NON-I/0 



7»3. DISK BASIC is activated by keying in one of the following commands to 
DOS: 



1. 


BASIC 


2. 


BASIC * 


3. 


BASIC n 


4. 


BASIC m 


5. 


BASIC and 


6. 


BASIC n,m,cmd 


7. 


BASIC m,n,cmd 


8. 


BASIC n,m 


9. 


BASIC m,n 


10. 


BASIC n,cmd 


11. 


BASIC m,cmd 



where: 

* means the user wants BASIC to reinstitute the program in the text 
buffer, using the same values for m and n as appear to exist in main 
memory. This allows the user to recover from an unwanted 'reset' or to 
get back to the same program after a CMD"S". If BASIC is able to accom- 
plish this, it forces 'LIST' as its first command. If BASIC is unable to 
reinstitute the program, it exits to DOS READY. BASIC * will not work if 
n was less than 2 or if the program was less than 3 lines. 

n = the number of fileareas that BASIC is to allocate, default = 3, max- 
imum - 15. This is the highest fan (filearea number) that will be used in 
any statement during this invocation of BASIC. If the BASIC program is to 
use field item files with standard record length not equal to 256, then n 
must be specified and must be suffixed with the character V (see example 4 
below) . 

m - memory size. The value m minus 1 is the highest memory location that 
BASIC is allowed to use. If m is not specified, the current DOS HIMEM 
value is used. All memory m and above is not used by BASIC and can be 
used for other routines such as printer drivers, special code USR 
routines, etc. 

omA = one line of BASIC text, consisting of one or more BASIC statements. 
This text line is considered direct keyboard input and will be executed as 
soon as initialization is completed. 

Remember, the DOS command activating BASIC is limited by DOS to a maximum of 80 
characters, including ENTER, and it is further limited to 32 characters, in- 
cluding ENTER if invoked via 'AUTO 1 . 

Any error encountered during initialization causes a return to DOS. 

If DOS is in RUN-ONLY state, the DOS command activating BASIC must contain a 
RUN or a LOAD (option R) statement. 

Examples : 

1. BASIC Brings up BASIC with 3 file areas, high memory set to the 
current value for HIMEM in DOS and displays 'READY', waiting for the 
operator's command. 

DISK BASIC NON-I/0 7-2 



• 



2. BASIC, RUN "XXX/BAS" Brings up BASIC with 3 file areas, high memory 
set to the current DOS HIMEM value, loads BASIC program XXX/BAS into the 
text area and starts its execution. 

3. BASIC, 9,48152, LOAD"XXX/BAS" Brings up BASIC with 9 file areas, high 
memory set to 48151 (1 less than 48152), loads BASIC program XXX/BAS into 
the text area and displays 'READY', waiting for the operator's command. 

4. BASIC, 3V This works the same as example 1 above, except that each 
of the 3 files areas is assigned an extra 256 byte buffer. This extra 
buffer per filearea is needed if the program will be using field item 
files with a record length other than 256. 

5. BASIC, CLEAR3000:A=1:RUN"XXX , ',V Brings up BASIC with 3 fileareas, 
sets its high memory value to DOS's current HIMEM value, performs CLEAR 
reserving 3(100 bytes for the string area, sets numeric variable A equal to 
1, loads BASIC program XXX and commences its execution without clearing 
the variables, thus leaving variable A intact for the program to inspect. 



7.4. NEwDOS/80 DISK BASIC allows the following 'direct' commands: 

(period) LIST the current text line. 

down-arrow LIST the next text line. If there is no next text line, 
performs as / . 

up-arrow LIST the text line before the current line. If none, 
performs as ; . 



; or shift-up-arrow 



LIST the first text line. 



/ or shift-down-arrow LIST the last line in text. Users having the 
newer ROM will find that shift-down-arrow is no longer a usable key; hence 
the need for / . 

: Scroll one display page toward the start of the text. When done, the 
previous current text line is now at the bottom of the display excepting 
that if the previous command was : or @ , the previous display's top 
line is now the new display's bottom line. The new current text line is 
the bottom line on the new display. 

6 Scroll one display page toward the end of text. When done, the pre- 
vious current text line is now the at the top of the display, and the new 
current text line is the bottom text line on the new display. 

, (comma) EDIT the current text line. 

Only 1 such command per direct statement line, and the command, to be seen, 
must be the first character of the input line (no line number or backspacing 
allowed) . 
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7.5. HSHDOS/80 DISK BASIC allows the truncation of the commands AUTO, DELETE, 
EDIT and LIST to A, D, E and L respectively when the following conditions are 
met: 

1. 1st character of the input line. 

2. Followed by either a period or a decimal digit. 

3. The input line does not contain an =. 



m 



7.6. DI and DU Two additional BASIC text editing functions are implemented 
using the following forms of direct command: 

1. DI aaaaa,bbbbb 

2. DI ., bbbbb 

3. DU aaaaa, bbbbb 

4. DU ., bbbbb 



where: 



aaaaa is the line number of the text line to be moved or duplicated, and 
bbbbb is the line number to be given the moved text line or the duplicate 
of the text line. 



DI means to delete the line at aaaaa and insert it at bbbbb. 

DO means insert at bbbbb a duplicate of the text line at aaaaa, but do 
not delete the line at aaaaa. 




Text referring to aaaaa is not altered to refer to bbbbb. If this is 
desirable, then use REKUM to move the text line. 

The use of a period in place of aaaaa causes aaaaa to default to the last 
line listed, edited or deleted. 



7,7. RUN and LOAD may now optionally retain all variables and open fileareas 
by using the V option in the following formats: 

RUN"filespecl",V 
LOAD M filespecl",V 

where filespecl is the filespec of the program file being executed. The LOAD 
with the V option executes exactly the same as the RUN with V option. The RUN 
with V option preserves all the variables, excepting DEFFN variables, during 
the execution of RUN; thus the variables existing before the RUN statement can 
be used after the RUN statement. Any fileareas open prior to the RUN are left 
open for use after the RUN statement. If the V option is specified, the R 
option may not be. See example 5 in section 7.3. 
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7.8. The MERGE statement has been expanded: 

MERGE will merge either an ASCII or a packed text file. 

MERGE may be executed as a direct statement or as a program statement. 

If MERGE is executed as a program statement, the MERGE statement must not 
be part of a DEPFN statement, a subroutine or a FOR-NEXT loop (as a POPS 
function is implicitly performed) , must be the last statement of the text 
line, must be followed by the text line where execution will continue 
after the MERGE, and the merge file must not contain a line whose number 
is the same as the number of a text line existing at the start of the 
execution of the merge (use CMD'V, DELETE to delete conflicting text lines 
before executing the MERGE). The merge protects all variables. The user 
must assure enough main memory space is available for the merge as error 
recovery is not possible if the merge fails once actual merging commences. 
Example: 

100 MERGE"XXX/BAS" 

110 X=l execution continues here after the MERGE is completed 



7.9. REHUM Renumber the Current BASIC Program. 

RENUM ssbss, iiiii ,ppppp, qqqqq [ ,U] ( ,X] 

RENUM , 
RENUM U 
RENUM X 
REKUM U,X 

The current BASIC program or a part of it may be renumbered while it resides in 
the text area. Via the U option, the RENUM does not actually perform renumber 
but only does its text error checking, thus allowing the undefined line numbers 
and some, but not all, syntax errors to be found. The user may, by proper 
choice of the new line number values, move a portion of the program to a dif- 
ferent place in the program with all references to any of the moved lines 
changed to the new lines numbers. Lastly, via the X option, RENUM will not 
declare as an error any undefined line number if that line number lies outside 
of the range of lines being renumbered, thus allowing a program to have ref- 
erences within it to lines that are intentionally not part of the program. 

The basic renumber command causes all text lines whose line numbers are greater 
than or equal to ppppp and less than or equal to qqqqq to he assigned new line 
numbers, ess as is the first new line number assigned with subsequent numbers 
generated by adding iiiii to the line number of the previous text line, sssss 
and iiiii must be in the range 1 - 65529 and have default value 10. ppppp must 
be in the range 1 - 65529, has default value 0. qqqqq must be in the range 1 - 
65529, greater than or equal to sssss, and has default value 65529. The range 
of newly generated line numbers must not encompass any old text lines that are 
not part of the resequenced range ppppp - qqqqq inclusive. So long as this 
rule is observed, the newly generated line number range may be placed anywhere 
in the text with the renumbered text moved to the proper new text location. 
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At least one parameter must be specified, tf the user wants to specify all 
defaults and neither X nor U, then use a comma as the only parameter. 

For the series sssss, iiiii,ppppp,qqqqq, if one or more of the 4 numbers are to 
use the default values, then commas must appear in the proper place to indicate 
which of the 4 values a given line number is for. See example 4 below. 

If the U option is specified, the text is not altered in any way and RENUM 
simply searches text for undefined line numbers and for some errors associated 
with BASIC statements that use line numbers. These errors are displayed in the 
following format: 

sssss/U - there is no text line sssss. 
sssss/X - text line sssss has syntax error, 
sssss/ S - text line sssss has a bad line number. 

If the X option is specified, references to non-existent text lines are not 
displayed as errors if that line number is also outside of the ppppp to qqqqq 
range. The X option is intended as aid to programmers who use a base program 
and overlay programs which refer to text lines in each other. 

If any error is encountered before text is altered, the command reverts to 
performing as if the U option had been specified and displays all the errors it 
can find. If an error is encountered after text alteration begins, 'FATAL 
ERROR. TEXT NOW BAD' is displayed and the 403 0H exit taken to DOS. The BASIC 
text must not be reclaimed (don't use BASIC *). 

If either SYS11/SYS or SYS13/SYS are not in the system when RENUM is executed, 
the system will exit to DOS READY (see section 5.5). 

RENUM will refuse to renumber a program whose first text line's number equals 
0. Use 'DI* to assign the line a number other than 0. Examples: 

1. RENUM U The BASIC text is checked for undefined line numbers and 
other errors that would normally be encountered in an actual renumber. 
The BASIC text is not altered. 

2. RENUM , The entire BASIC text is renumbered using an increment of 
10. The first text line is assigned line number 10, the 2nd assigned line 
number 20, and so on. 

3. RENUM 100,100 The entire BASIC text is renumbered using an incre- 
ment of 100. The first text line is assigned line number 100, the 2nd is 
assigned 200, and so on. 

4. RENUM 2050, ,2050,3160 All text lines from and including any line 
numbered 2050 to and including any line numbered 3160 are renumbered using 
an increment of 10. The first renumbered line is assigned line number 
2050, the second is assigned 2060, and so on. 

5. RENUM 30000,5,15365,18112 All text lines from and including any 
line numbered 15365 to and including any line numbered 18112 are renumber- 
ed using an increment of 5. The first renumbered line is assigned line 
number 30000, the 2nd is assigned 30005, and so on. The renumbered text 
lines are moved to the new positions in the text. 
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7.10. KEF The BASIC statement REF allows the BASIC programmer to find all 
places in the program where a line number, an integer, a variable, a string, a 
function code, a packed sequence of characters or an unpacked sequence of 
characters is referenced. REF has the following formats: 

1. REF* Display full reference list for all line numbers, inte- 
gers and variables. 

2. REF$ Print on the printer a full reference list for all line 
numbers, integers and variables. 

3. REFnn Display all references to the variable(s) named nn. If nn 
is only 1 character, a blank is assumed for the second, nn may not be 
more than 2 chars and must not have a type suffix. 

A. REFsssss Display all references to the line number and/or integer 
sssss where sssss is a 1-5 decimal digit number between and 99999. 
Hexadecimal or octal references within the text are not listed. 

5 . REF*nn 

6. REF$nn 

7. REF*sssss 



8. REF$sssss 

9. REF Display the next text line containing at least one refer- 
ence to the variable or number specified by the last REFnn or REFsssss 
statement executed. If there are no more referencing text lines, 'TEXT 
END' will be displayed. If 'REF' entered again, the first referencing 
text line will be listed. Remembrance of the search variable name or 
number and the current search line number within the text is usually (but 
not always) lost when any command involving DOS is executed. 

10. REF=xxx The character sequence xxx is packed by the standard BASIC 
text packing routine. The BASIC text is then searched for a match on the 
packed xxx value and the line numbers listed for all lines containing the 
packed xxx value. If the packed value xxx is more than 16 bytes long, 
only the first 16 packed bytes participate in the compare. This format of 
REF is to used when the user wants to know where in the text a BASIC fun- 
ction code (i.e., PRINT, LPRIKT, GOTO, etc) is used. The text lines con- 
taining xxx can be displayed one at a time by repeated issuance of the 
format 9 REF command. 

11. REF"xxx This format operates similar to format 10 except that xxx 
is not packed, xxx is considered a string unless xxx itself contains a ". 
This format allows xxx to be found in strings and comments. 

12. REF@sssss This statement is similar to format 9 except that the 
search will start with 1st text line whose line number is greater than or 
equal to sssss. 

Press BREAK to pause, ENTER to continue, and up-arrow to terminate the REF 
function. Formats 5-8 are the same as 1 and 2, except listing/printing starts 
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with the specified variable name or decimal number, if it exists, or the next 
higher existing name or number, if not. 

If SYS12/SYS is not in the system when the REF statement is executed, the 
system will exit to DOS (see section 5.5). 



7.11. Text String Lower Case Suppression (Model I only) Users who do not 
have the hardware lower case modification or those that do but don't use a 
lower case driver to bypass the ROM display routine will occasionally be 
puzzled why some string compares fail and syntax errors appear in perfect 
appearing statements. This is due to the acceptance of lower case letters into 
strings which display as upper, and the acceptance of lower case @ into text 
statements. Remember the ROM swaps lower case to upper and vice versa before 
BASIC sees the characters. In the case of data, there is nothing that can be 
done about this problem except to remember that if it appears equal on the 
display, there still may be a lower case/upper case mismatch in memory. For 
text input, if system option AS = Y, text string lower case letters, but not 
lower case @, will be forced to upper case, eliminating many of these problems. 



7.12. RUH-OHXY For DISK BASIC there are two ways BASIC can be forced to run 
in RUN-ONLY mode: (1) if system option AB = Y, and (2) if the BASIC program 
file is password protected, passwords are enabled, the access password spec- 
ified in the RUN or LOAD (option R) statement and the access level - EXEC. 

If system option AB = Y, the DOS command activating BASIC must contain the 
necessary RUN or LOAD (option R) statement to start a program executing as the 
operator is not allowed to input any direct command statements. 

In RUN-ONLY, the BREAK key is disabled and BASIC is inhibited from accepting 
direct statements (data is OK) from the operator. The program has full con- 
trol, and must exercise it. A menu program can issue RUN. or LOAD (option R) 
statements for other BASIC programs, and those programs can do the same to 
return to the MENU program or go on to the next program of a sequence. Op- 
tionally, a base program may remain in memory at all times, and via CMD n F", 
DELETE and MERGE, bring in overlay programs as necessary. Programmers should 
carefully study available options under RUN, MERGE, LOAD, and CMD M F functions. 



7.13. Comparisons in the use of the function CHD between KEHDOS/80 and TRSDOS. 

1. CM^A" Not implemented; use CMD"S". 

2. CMD 1 '^ Not used on the Model I by NEWDOS/80 nor TRSDOS. TRSDOS 1 
Model III use is not implemented in NEWDOS/80; use CMD M BREAK > Y/N" 

3. (MD^C" This command (1) compresses out all spaces from the program 
text, excepting for those within strings, and (2) deletes all remarks from 
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the text, including entirely those lines which are entirely remarks. The 
statement CMD"C",S compresses out all spaces from the program text, ex- 
cepting those within strings and remarks. The statement CMD"C n ,R dele- 
tes all remarks from the text, including deleting entirely those lines 
which were entirely remarks. 

In some cases, GOTO, GOSUB, etc. refer to a text line that is entire- 
ly remarks and the deletion of remarks from the text will cause these 
referenced lines to disappear. The programs should be altered to have 
these GOTOs and GOSUBs refer to text lines that are not entirely re- 
■ marks. After remarks have been deleted from a program, execute 

RENUM U to determine if there are any undefined line numbers result- 
ing. 

Though BASIC is designed to ignore spaces that are not in text 
remarks or character strings, the removal of spaces from text can 
still cause confusing situations. For example, compr easing 

10 FIELD 1, 20 AS C5 
20 IF F OR D THEN 10 
to 

10 FIELD1,20A$C$ 
20 IFFORDTHENl* 

will cause syntax errors to occur for both lines during execution 
after either (l) the program has been stored in ASCII and then read 
back in or (2) the lines have been edited. To avoid these problems 
that may exist for weeks or months before either of the above two 
Conditions occur, the CMD"C" function automatically unpacks each 
compressed text line, packs it again and compares the new packing 
with the old that existed before the spaces were compressed out. For 
any text line where the two packings are different in any way, the 
spaces are restored into that text line (remarks, if deleted, remain 
deleted) and the line's number is listed on the display. The user 
may then inspect these lines and remove spaces that won't affect the 
program. For any given program, there should be very few lines 
rejected by CME"C". 

4. CMD*D™ TBLSDOS 1 meaning is not implemented on the Model III under 
NWDOS/80; use CMD N doscmd'\ On the Model I, CMD"D" still invokes DEBUG 
though 123 is the preferable method. 

5. CMD'E" Displays the BUS error messaged associated the latest DOS 
error encountered by BASIC, 

6. CHDT" Not used in TRSDOS. In NEWDOS/80, there are two formats: 

1. CMD"F",fc used when the function code fc must be fundable by 
REF, REHUM and others. 

1. CMD"F=fc" used when the function code fc is not to been seen by 
REF, RENUM, etc* or where the specially defined function code could 
be confused by the normal text packing routine. 

These CMD"F functions are specified in sections 7.15. thru 7.20- 
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7. Qfl>*t" Not used on the Model I by either HEWDOS/80 or TRSDOS. 
TRSDOS 1 Hodel III use is not implemented in HEWDOS/80; uae CMD"dos-cmd H . 

8. CHD P J" Calendar Date Conversion. 

CMD 1, j" J datel,date2 

converts the expression datel to the appropriate format and stores 
the result in the string variable date2. If datel is in mm/dd/yy 
format, date2 is stored in ddd format and if datel is in -yy/ddd 
format, date2 ia stored in mm/dd/yy format where: 

mm is a two digit month value between 01 and 12. 

dd is a two digit day-of-the-month value between 01 and 31. 

ddd is a three digit day-of-the-year value between #01 and 366. 

yy ia a two digit relative y ear-within- century value between 00 and 

99. For leap year conversions, yy is assumed to be in the 20th 

century, i.e., from 1900 to 1999, 

9. QQ-V TRSDOS Model III meaning not implemented in NEWDGS/B0; use 
CMD"LOAD,fileapec". This function is not used on the Model I. 

10. CHD^O" Array Sort; see discussion below (section 7.21.) for CMD"0". 

11. Qffi^p" Not used on the Model I. TRSDOS' Model III meaning is not 
implemented in NEWDOS/80; use FEEK(&H37E8) to obtain the - 255 value for 
the current printer status. 

12. OOTR" TRSDOS' Model III meaning is not implemented in NEWDOS/80; 
use CMD"CLOCK,Y". On the Model I, CMB'V still reenables the interrupts 
as before. 

13. QSD M S n Exit BASIC and return to DOS READY state. However, if the 
command is of the form CMXTS-doscmd", then the following occur: 

1. The DOS command doscmd ia moved into the DOS command buffer. 

2. BASIC exited, 

3. The DOS command placed into the DOS buffer is executed imme- 
diately without an intervening DOS READY. 

4. When that command is completed, control returns to DOS READY and 
not to BASIC. 

14. (MOT* XRSDOS' Model III meaning is not implemented in NEWDOS780; 
use CMD"CI«0CK,N". On the Model I, CMD"T n still disables the interrupts as 
before. 

15. CUD**" Not used on the Model I by NEWDOS/80. TRSDOS* Model III 
meaning is not implemented; use the REE command. 

16. CHD^E" Not uaed on the Model I by NEWD0S/8D. TRSDOS' Model III 
meaning is not implemented; use CMD" ROUTE, . . . ", 
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7.14 CMD'doecmd" 

If the string express ion associated with the CMD function has two or more char- 
acters and does not start with either "S=" or "F=", then the string is assumed 
to he a command to be executed by DOS. BASIC moves the command to DOS' command 
buffer, sets DOS to KINI-DOS mode, and calls DOS to execute the command via 
441911, DOS-CALL. Upoo return, BASIC turns off DOS' MINI-DCS mode. If DOS has 
rejected the command because it was not legal under MINI-DOS, BASIC then at- 
tempts to reissue the command to DOE under normal mode by doing the following: 

If approximately 8,0(50 bytes are not available between the top of BASIC'S 
array areas and the bottom of BASIC s stack (which is immediately below 
the string area), BASIC declares OH ('OUT OF MEMORY') error and terminates 
the current statement. If the space is available, BASIC moves all of mem- 
ory from 5200R to 70FFH to that free area, sets itself to use stack area 
7000K-71FFH and computes a checksum over the region from 7100H to the top 
of BASIC's memory (takes about 2 seconds). Then it calls DOS to execute 
the DOS command . Upon return from DOS, BASIC moves the saved region back 
to 5200H-70FFH and recomputes the checksum (again, another 2 seconds). If 
the check fails, this means that the DOS command executed has altered some 
of BASIC'S bytes; BASIC cannot continue and exits to DOS with 'BAD MEMORY* 
error. 

Whichever vay the command was executed, BASIC now checks the return code from 
DOS. If an error occurred and the error message has already been displayed, 
BASIC terminates the CMD"doscmd" statement with 'PREVIOUSLY DISPLAYED ERROR' 
error state. If a DOS error occurred, BASIC calls 440 9H to display the DOS 
error message and terminates the CMD' 1 doscmd" statement with 'DOS ERROR' error 
state. If no error occurred, BASIC continues with normal processing. 

Any BOS library command or assembly language program (that will execute using 
only the 5200H - 6FFFH region and/ or a non-BASIC, non-DOS region of main mem- 
ory) can be executed in this fashion. SUPERZAP and DIRCHECK are two programs 
that may be executed through CMD"doscmd". FORMAT and most forms of COPY can be 
done; however, single drive, two diskette copies cannot be done as they require 
the maximum amount of memory. Also, don't specify the UBB parameter in COPY. 

Remember, BOS commands are limited to 80 characters, including the ENTER char- 
acter that BASIC will append to the doscmd string when moved to the DOS command 
buffer. 

User programs are warned to leave the Model I memory area 4080H -41FFR (Model 
III area 4080ft - 41E2H) alone except where alteration is in conformance with 
BASIC'S current uses. 

CMD"BASIC" should never be executed. If for some reason the programmer wants 
to exit BASIC and return, use CMD"S=BASIC". 

Almost all DOS commands may be executed via CMD"doscmd'\ Examples: 

1. CMD"DIR 1" list a directory 

2. CMD"C0PY XXX;0 YYY:1" copy a file 

3. CMD"COPY 1 07/10/81 FMT" full diskette copy, with format 

4. CMD"SUPERZAP" executes program SUPER2AP and return to BASIC 

5. CMD"DO CHAINFIL" perform chain file functions and return 
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7.15 Qa> B F**KttS", QO-F-POTl" and CHD"F=IOT1": 

If the statement is CMD'^POPS", then all returns and FOR-next controls are 
purged, leaving BASIC with bo outstanding returns or nexte. When done, execu- 
tion continues with the next statement. The purpose of this statement is to 
allow the programmer to ' hail-out ' of complex coding and return to BASIC 1 & 
first level. This avoids leaving residual information in BASIC* control stack 
which on recursive returns to the high level without CMD"F-POPS" will 
eventually cause program failure. 

If the statement was CMD"F-POPR", then the current GOSUB level is purged along 
with any outstanding FOR-NEXTs for that level* This is the same as return ex- 
cept control does net pass to the statement following the associated GOSUB, but 
instead passes to the statement following the CMD h F«POFR" statement. 

If the statement is CMD"F-POPN", then the most recently established FOR-NEXT' a 
control data is purged. This is the same as 'NEXT' where the loop limit lb 
exceeded. Execution continues with the statement following the CMD ,, F=FOPN" 
statement. 

If the statement is CMD"F=POFN ,f vn where vn is a variable name, the FOR-NEXT 
loop associated with vn is purged along with any other FOE-NEXT loops estab- 
lished while vn's loop was outstanding. Execution is the same as for 'NEXT vn' 
when the loop is to end. Execution continues with the statement following the 
CMD"F=POPN" vn statement. The purpose of CMD"F-POPK" is to allow breaking out 
of a loop while not Leaving residual loop control information that can confuse 
the programmer if he/she sub sequentially uses FOR-NEXT variables in reverse 
order • 



7.16. CHD"**SASZ* Change BASIC'S string area size without affecting or 
clearing the variables. 

GMD"F=SASZ",expl 

allows the string area size to be changed without clearing the variables* expl 
must be a value large enough allow the string area to contain the strings that 
it contains when the statement is executed. An error will be generated if expl 
is too small or is too large (i.e., will cause overlap with the text, scalar 
and array areas). Example: 

CHD"F=SASZ",4000 



7.17. CHD B F«ERASE n and CMD ,, F^■KM^P ,, Selective clearing of BASIC variables. 

CMD"F=ERASS",vul,vn2,vn3... allows the specified variables to he 
cleared. If a specified variable is within an array, the entire array is 
cleared. The size of the string area is not changed. This statement 
should be used when, an array is no longer needed or the user wishes to 
red intension it by a subsequent DIM statement. This statement may be 
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multi-text lines as described for CMD"F=KEEP" below. 

CMD"F-KEEP l1 ,vnl ,vn2,vn3». . causes all variables to be cleared except 
those specified and except specially defined variables such as those de~ fined 
by a DEFFN statement. The size of the string area is not changed. If no 
variable names are specified* all variables are cleared, except the special 
ones. If a specified variable name is within an array, the entire array is 
exempted from the clear. The statement may specify as many var- iable names as 
desired with overflow from one text line to the next non- comment text line 
taking place whenever the last variable name of a text line is followed by a 
comma . Example: 

CMD ir F-KEEP" l A$ 1 B2,C,D#, 'statement first line 
E!,F,G$, 'statement 2nd line 

REM this line is bypassed 
H!,I 'statement last line 



7,18, CM» W F ,, > BKUSTE Dynamic deletion of text lines: 

CMD'V, DELETE lnl-ln2 

Tbis statement allows the text lines from and including any line numbered lnl 
to and including any line numbered ln2 to be deleted during program execution. 
All variables are retained, excepting that DEFFN variables for DEFFN statements 
in the delete range are cleared. The string area size is not changed. Any 
string variable whose current string was actually in the deleted text area has 
that string moved to the string area. CME"F", DELETE must not be executed as a 
direct statement, must not be contained in a DEFFN statement, a subroutine or a 
F0R-MEXT loop (as a POPE function is implicitly performed), must be the last 
statement on its text line and must be followed by the text line where execu- 
tion will continue after the delete. Example: 

100 CMD"F", DELETE 10500-15000 

11(5 X=l execution continues here after the DELETE is completed 



7.19. CKD n F-SWAF M Swapping of variable contents : 
CMD"F=SwAP",vnl ,vn2 

This function swaps the value of variable vnl with that of variable vn2. Both 
variables must be of the same type, i.e., both strings, both single precision 
floating point, etc. Example: 

CMD H F=SWAP",A$,B$ 
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7.20, am^^ss" BASIC single stepping: 

1. CMD N F-SS ,f turn on h ingle stepping 

2. (W'F-SS'Mnl single stepping starts at line lnl. 
3* CMD"F-SS",N turn off single stepping. 

The BASIC programmer may now single step through program execution. Using 
either format 1 or 2 above sets BASIC into single step mode, though for format 
2, actual single stepping does not start until text line lnl is the next line 
to be executed. A single BASIC text line is executed for each step, and be- 
tween steps the line number for the next line to be executed is displayed in 
'@nnnnn' format in the display upper right corner to indicate that BASIC is 
waiting for the operator to respond. Responding ENTER causes line nnnnn to be 
executed and then BASIC waits for user response again. Responding BREAK causes 
execution to be broken in the normal manner though it should be noted that the 
line number the BREAK shows is for the line just executed or being executed 
while the 'Gnnnnn 1 dispLay is for the next line to be executed. If the user 
does not change text during BREAK, the program may be continued via CONT; in 
this case, the 'gnnnnn' display will immediately reappear without execution of 
a line. Pressing ENTER will then execute the line. While in BREAK, the oper- 
ator may turn single stepping on or off as desired without affecting the abil- 
ity to CONT. If the BREAK occurs before RUN or LQAD,R executes one text line, 
CONT will not work. 

Single stepping or the scheduling of the single stepping to start when a par- 
ticular text line is encountered remains in effect until either CMD"F-SS n ,N is 
executed to turn it off or until a format 2 type stepping command is executed, 
wherein stepping goes off until the specified line is encountered. The execu- 
tion of RUN, LQ£D, NEW, etc, does affect single stepping state. 



7.21. CMD"0 M The main memory BASIC array sort has 2 formats: 

1. CMD"0 B ,ii,avl[,av2 3 {direct sort) 

2, GMD"0",n,*iavl J av2[,av3,.,.] {indirect sort) 

In explaining this sort, the term REN is used and is defined to mean a Relative 
Element Humber identifying an array element. The elements within any BASIC 
array, regardless of dimension, are integer numbered from up. If an array 
has only one dimension, then an element 1 s REN is simply the value of its sub- 
script and if you use only single dimensioned arrays, you can ignore the rest 
of this paragraph. However, if you use multi- dimensional arrays, then you 
should know which method to use to increment array subscript values in order to 
extract elements in the sorted order. CMD"0 N does not care what dimension the 
arrays have; it simply counts off the array elements in the order BASIC stores 
them in main memory. Yon, the programmer , do care as you must use subscripts 
in order to access the array elements. For multi-dimensioned arrays, the rule 
for computing the REN is complex and can best be illustrated by a three dimen- 
sion array example using two statements: 

DIM A(R1,R2,R3) 
Y - A(X1,X2,X3) 
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where the REN of this element is computed as Xl+X2*(Rl+l)+X3*(Rl+l)*(R2+l) . If 
the array had only two dimensions, then the REM would be X1+X2*(R1+1) , and* of 
course, if the array had only one dimension, the REN would simply be XI. 

Tf the CMD"O n statement specifies more than one array, excluding iavl, then the 
RENs for the first sort item in each array , excluding iavl, must be equal. 

The sorting order used has one level for each array specified, excluding the 
iavl array, with highest to lowest level in the order, left to right, of the 
array variables in the CMD statement. Within each level, the normal sort order 
is ascending ASCII (actually hexadecimal) numeric value for character string 
arrays and most negative to most positive value for numeric arrays, However, 
if the array variable in the CMD statement is prefixed vith a minus sign 
{example: -A#(0) ), then the order of sort within that level is descending 
ASCII (actually hexadecimal) numeric value for character string arrays and most 
positive to most negative value for numeric arrays. A null compare string 
character is considered to have a numeric value less than 0. 

Normally in character compares, the entire string is used in the compare. 
However, if the array variable in the CMD statement is suffixed with a field of 
the form (x,y) (Example: A$(l)(5 a 4) ), then the compare starts with the xth 
character of the string and compares using only y characters. 

n is the number of elements in each of the arrays participating in the sort. 
Only n elements from each array participate in the sort. Elements of an array 
below or above the n elements specified do not participate. If n is a zero 
value, then for the sort, n is set to the number of elements in first array 
specified from and including the element specified through and including the 
last element of the array. 

Tf the number of elements in any array from and including the specified element 
to and including the array's last element is less than n, FC error is declared. 

A maximum of 9 arrays may be specified. All array variable subscripts, except 
for the indirect array if specified, must evaluate to the same REB value. 

Format 1 is a direct sort meaning that the elements of all 1 to 9 arrays are 
moved around to conform to the desired sort order. 

avl ciust be specified; av2 and up are optional. 

The resulting order of the n elements in each array is the same for each 
array (i.e., the arrays are not sorted independently). Thus, if the jth 
element of array 1 is sorted into the kth element slot, then for each of 
the other arrays, if any, the jth element is also placed into the kth 
element slot. 

Format 1 is compatible with TRSDOS Model III BASIC CMD"0" if and only if 
only one array variable is specified, it is for a string array and n is an 
integer variable. 

Format 2 is an indirect sort. In this sort, only the n elements of array iavl 
are altered; the other arrays are not changed in any way. The intent of format 
2 is to allow a sorted sequence to be determined without actually changing the 
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arrays supplying the sort values. A user may have a group of data records 
spread across a number of arrays such that a record consists of one element 
from each array , with the RES of each of those elements making up the record 
equalling the record number. By using format 2 with the indirect array, the 
user may effectively sort the records using a subset of the items as the sort 
criteria and without actually rearranging the order of the records, thus leav- 
ing them in record number order. 

Format 2, as opposed to format 1, is indicated by specifying the iavl 
array variable, prefixed by an * . 

iavl must be an integer array variable. 

av2 must be specified; av3 and up are optional. 

The u consecutive elements starting at iavl are initialized with the RENs 
corresponding to the n consecutive elements of array av2 {which also 
correspond to the RENs for the other arrays, if any). 

During sorting only array iavl is altered; , array a av2 and up are not 
altered* 

Upon completion, the n elements of array iavl are in the desired sorted 
order such that by using successive values out of array iavl as sub- 
scripts, the user may access elements from any of the other arrays (that 
are single dimensioned) in that sorted order. Accessing multi- dimensioned 
arrays is more complex and is left as an exercise for the more advanced 
user. 

Example program using a number of sorts: 

10 DIM Htt$(200), AMH100), LH$<100), IX%{100) , ZC1(50) , L$(50) 

30 X-150 

40 CMD"O",X,NM$(0) 

60 CMD"0".X,-NM${25) 

70 CMD ,, O ,, ,0,™AM!(1>,1U$(1)(5,3) 

80 ckd"oM*0.*ix;e(0),zc!<1),l$(i) 

At line 40 the first 150 elements of array NM$ (elements NM$(0) to 
NM${149) ) are sorted in ascending order. If any of the strings are null, 
they will appear first in the resulting array. The last 51 elements of 
array NM$ (elements NM${150) to NM$(200) ) do not participate in the sort 
and are left unchanged. 

At line 60 elements NM$(25) through MM$(174) are sorted into descending 
order, with null strings, if any, appearing as the end elements of those 
150 elements. The first 25 and the last 26 elements of the array do not 
participate in the sort. 

At line 70 the AMI and LN$ arrays are both sorted, both in the same order 
which is first by descending order of AMI array values and then, vhere AMI 
array values are equal, by ascending order of LN$ array values where only 
the 5th, 6th and 7th characters of the LN$ array elements participate in 
the sort determination. If a LN$ array element has less than 5 charact- 
ers, it is considered a null for sort determination purposes. AM!(0) and 
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CAREFULLY STUDY chapter 11 of NEWDOS/ 80 documentation for instructions on how 
to apply zaps. 

Some modules have multiple versions with the zaps different in each version. 
Use the verify to determine which version you have and apply the appropriate 
zap(s). If you have a version different from any listed (i.e., the verifyCs) 
do not match, contact the program's distributor or Apparat)* Apparat is trying 
to get the program creator /maintainer/ distributor to create and distribute the 
necessary zaps to run with NEWDOS/80, Version 2, hut where this does not occur 
and for widely used programs , Apparat will generate any necessary zaps. If 
Apparat decides to generate the zaps and does not have your particular version, 
you will be asked to send the version you have on a diskette (as. a gift to 
Apparat, see chapter 11) to Apparat so that Apparat may determine the appro- 
priate zaps; Apparat will not seek out your version from another source, and 
will not create a zap from a paper listing. 

******** zap 001 ******** 08/04/ Si ******** V2M1 ******** 

Mandatory saps to Microsoft's EDIT/ CMD to enable it to run with NEWDOS/ 80 . You 
must maintain separate copies of this module for each of TR&D03 and NEWDOS ae 
the module for one system is incompatible with the that for other though the 
files they manipulate are compatible. These changes are due to the FOB'e NEXT 
and EOF fields being defined in NEWDOS differently than in TRSDOS, 

E DIT/ CMD , 3 8 , E8 change 

7E E6 7F 7E 21 FE FF CA 58 78 EE 80 87 DA 5D 78 to 

7E 60 69 B6 01 30 01 2B 29 07 30 01 23 18 04 78 

EDIT/ CMD, 32 ,A2 change 

78 E6 7F C2 28 72 78 EE to 78 06 01 30 08 18 04 EE 



******** ZAP 002 ******** 08/04/81 ******** V2M1 ******** 

Mandatory zap for PENCIL/ CMD to disable the alteration of a DOS location by 
PENCIL. This alteration of DOS by PENCIL is not needed in either NEWDOS/80 or 
NEWDOS/ 21. 

PENCIL/ CMD, 00 ,AE change F3 32 9B 46 C3 to F3 00 00 00 C3 

Apparat has been advised that the following two zaps to PENCIL/ CMD will (1) 
allow PENCIL/ CMD to read the directory properly and (2) enable the use of 
MI MI-DOS under PENCIL/ CMD. 

PENCIL/ CMD, 5 ,60 change 58 23 22 to 56 00 22 

PENCIL/ CMD, 00 ,61 change 54 22 16 40 21 to 54 00 00 00 21 

This latter zap prevents PENCIL/ CMD from using its own keyboard routine, 
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thereby defaulting back to HEWDOS/30'6 wherein 'DFG' invoking MIHI-DOS can be 
spotted. 



******** zap 003 ******** 08/04/81 ******** V2M1 ******** 

Mandatory zap to Radio Shack* a programs SCRIPSIT/UC and SCRIPSIT/ LC to run 
under NEWDOS/80 (and NEWDOS/21). The user should maintain separate copies fox 
NEWDOS and for TRSDOS as the programs for each system are incompatible with the 
other system even though the files they manipulate are compatible. The first 3 
changes are necessary because of the different way the PCB's NEXT and EOF 
fields are maintained. If you are running NEWDOS and files appear to load 
short one sector, check to make sure these saps are in. The 4 th zap causes 
DOS' HIMEM address value in 4Q49H - 404AH to be used as SCRIPSIT 's high memory. 
The 5th aap re-enables the interrupts so MINI-DOS can be invoked from SCRIPSIT. 

SCRIPS IT/UC, 11 ,75 and SCRIPSIT/LC, 11 ,75 

change 47 00 CD 6E 7A 4F to 47 00 3 A D9 7C 4F 

SCRIPS IT/UC , 1 1 , FB and SCRIPSIT/ LC , 1 1 ,FB 
change E7 C4 EF 5D 7 9 to B7 32 B6 7C C4 

SCRIPS IT/ UC, 12, 00 and SCRIPSIT/LC ,12, 00 
change 32 B9 7C 11 to EF 5D 00 11 

SCR IPS IT/ UC, 00, 63 and SCRIFSIl/LC,Q0,63 change 
7C 21 FF 00 25 7E 2F 77 AE 20 F9 22 to 
7C 2A 49 40 00 00 00 00 00 00 00 22 

SCRIPSIT/ Z7C, 00 ,C3 and SCRIPSIT/LC, 00, C3 
change 57 F3 ED to 57 00 ED 



******** zap 004 ******** 08/04/61 ******** V2M1 ******** 

Optional sap to increase drive power on delay to the full one second used in 

older DOSs. NEWDOS/ 80 waits only 1/2 second for the the drives to attain 

rotational speed during power on select. If you feel the drives would perform 
better with the longer delay, apply this zap. 

SVS0/SYS,04,C3 change 06 80 CB to 06 FF CB 



******** K AP 005 ******** 08/04/81 ******** V2M1 ******** 

Mandatory zap for APL&0/CMD to enable it to run with NEWDOS/ 80. APL80/CHD 
references a routine internal to DOS that is in a different location in 
NEWDOS/ 80 than it was for TRSDOS and NEWDOS/ 21. 

APL80/CMD,12,74 change 21 A2 4B to 21 B4 4B 

AFLS0/CMD,14,52 change 21 A2 4B to 21 B4 4E 
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******** zAF 006 ******** OS/ 04/ 81 ******** V2M1 ******** 

Optional zap to EDTASM/CMD to disable the lover case to upper case conversion 
done by EDTASM's keyboard input routine. Most functions within EDTASM will 
still require upper case, but comments and operands enclosed in single quotes 
(for DEFM and DEFB) will accept lower case. 

EDTASM/ CHD, 2 8, El change FE 61 D8 to FB 80 D& 



******** zap 007 ******** 08/04/81 ******** V2M1 ******** 
This is information rather than an actual fcap. 

1. Where possible, the HEWD0S/80 modules have reserved zap areas . Apparat 
purposely did not mention them in its documentation as it did not want to draw 
attention to them. Users are hereby warned that Apparat will preempt these 
areas without preliminary notice and in itE zap verifies will expect these 
areas to contain zeroes » Users who apply non-Apparat zaps into these areas 
should carefully maintain logs of what they have done to compare against future 
NEWDOS/80 zaps for area conflicts. 

2. The DOS command ATTRlB (see section 2.3) has an additional optional param- 
eter, LRL-xxx, not specified in that section. LRL=jho[ specifies the new log- 
ical record length of records in the file where xxx is an integer between 1 and 
256, This record length is used now only by D1R, but if user processing 
assumes a file has a given record length, some users may want the DIR display 
to reflect it. 

3. MINI-DOS (see section 4.2) is illegal under BOS-CALL (see section 4.4). If 
the DFG keys are depressed while DOS is under DOS-CALL, the triple key 
depression will be ignored. 

4. DOS command ROUTE (see section 2.43) has been altered such that existing 
routes are displayed only if the ROUTE command has no parameters. 

5. DOS command COPY (see section 2,14), format 6 (CEF) has a new optional 
parameter DFO (Destination Files Only). If DFO is specified, then file 
contents are copied if and only if the file previously existed on both the 
destination and source diskettes. DFO is mutually exclusive with FMT. 

6. DOS command FORMAT (see section 2.22) has a new optional parameter RWF (RaW 
Format). If RWF is specified, all errors are ignored and each track is 
formatted once, whether or not the format actually takes. RWF is used when the 
user wishes to obliterate the information on a damaged diskette and doesn't 
have a magnet. RWF is mutually exclusive with KDN, KDD, DflSL, DDGA and PFST. 



******** zap 008 ********* 08/04/81 ********* V2M1 ******** 

Mandatory zap to PROFILE'S module TNIT to correct for a different error code 
returned by NEWDOS/80 and to allow for KZ error state to take precedence over C 
or NO state on return from 4420H call. With this change, the zapped module 
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will still run under TRSDOS. This zap is for 3 different versions of the same 
module. 

INIT, 00,54 change 

44 38 09 28 OF FE 1A 28 13 C3 3F 52 CD to 

44 20 19 00 00 00 00 00 00 00 30 08 CD 

If the above doesn't verify, then try one or the other locations below. 

IN IT, 00 ,63 or INIT,00,64 change 

44 38 11 28 07 FE 1A 28 13 C3 47 52 CD to 

44 20 19 00 00 00 00 00 00 00 38 08 CD 

For those interested and for some PROFILE modules, the following optional zap 
will reenable the interrupts so '123' and 'DFG 1 can be used under PROFILE and 
NEWD0S/80. 

FR0FILE/CMD,11 ,45 change F3 CD to 00 CD 



******** ZAP 009 ******** 08/04/81 ********* V2M1 ******** 

Mandatory zap to Racet'a Infinite Basic IBL0AD/CMD module to enable it to run 
under HEflDOS/80 as well as TRSDOS. 

IBL0AD/CMD/CMD,08,15 change 

15 21 B6 7 9 11 F4 79 CD 36 44 28 to 15 11 F4 79 CD 13 00 32 B6 79 28 



******** zap 010 ******** 08/04/81 ********* V2M1 ******** 

Mandatory zap to Racet's DSM module DSMB/CMD to adjust for NEWDOS/SO's require- 
ment that a filespec's type have a maximum of 3 chars and that a fileepec end 
with a terminator. This corrects only for the filespec DSKC/CMDPATCHFATCHPATCH 
such that if a user patches in a different filespec, he/she will have to apply 
the 03 byte at the end of that fileepec. 

DSMB/CMD,03,C2 change 44 50 41 to 44 03 41 



******** ZAP 011 ******** 08/04/81 ******** V2K1 ******** 

Mandatory zap to allow VISICALC to operate with NEWDOS/80. The resulting zap- 
ped module will not run with TRSDOS or NEWD0S21; so maintain 2 different 
versiouB. This zap deals with the different handling by WEWDOS/80 of the user 
25ms interrupt routines (see sections 3.8 and 3.9). 

VC/CMD,03,2B change 

09 3E 00 21 20 03 22 51 9F C9 79 to 09 18 BB 00 00 0* 0B C3 EF 9B 79 

VC/CMD,75,15 change 11 28 9C 22 to 11 IE 55 22 
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VC/CMp.7 5,24 change 

C9 3K 03 C3 13 44 CD 4E 53 F5 CD 16 9C 28 OE 3E to 

C9 11 IE 55 C3 13 44 CD 4E 53 CD 16 9C C8 00 3E 



Mandatory zap to VISICALC to adjust for NEWDQS/80's difference from TRSDOS on a 
returned error code causing VISlCALC's directory search to hang if any of the 4 
drives are not present or have no diskette mounted. This zap is not 
incompatible with TRSDOS. 

VC/CHE,73,01 change C9 FE 18 20 to C9 37 C9 20 



******** ZAP 012 ******** 08/04/81 ******** V2M1 ******** 

Optional sap to increase or decrease the sensitivity of double density diskette 
formatting. One of three byte patterns can be chosen, depending on the relia- 
bility of your interface, drive and diskettes. The more sensitive the byte 
pattern, the greater the probability a marginal diskette will fail format and 
the lesser the probability that having formatted successfully, the diskette 
will fail later (under normal careful handling). The less sensitive the byte 
pattern, the lesser the probability a marginal diskette will fail format and 
the greater the probability that having formatted successfully, the diskette 
will fail later. The byte patterns are: 

1. E5 E5 » least sensitive. during formatting. This was and is the 
single density standard pattern, 

2. 5B 5B ■ intermediate sensitivity during formatting. This is the 
TRSDOS Model III pattern. 

3. 6D B6 = most sensitive during formatting, This pattern strains the 
disk formatting and if tbe interface, drives and diskettes are not in 
first class condition, 30% or more of the diskettes will fail formatting. 

Depending upon the frequency of format failures to diskette failures at other 
times, the user chooses which of the three 2 byte patterns to use and inserts 
them in the following locations t first checking that one of the three patterns 
is already at those locations. Each location receives both bytes, and as a 
check on each location, the preceding byte is F5. 

SYS6/SYS ,31,D9 

SYS6/SlfS,31,F3 



******** ZAF 013 ******** 08/03/81 ******** V2H1 ******** 

Optional aap to allow tbe COPY function to use Model III diskettes in the. 
TRSDOS 1.2 or earlier directory format instead of the TRSDOS 1.3 format the 
COPY command is prepared to handle. The zap must be backed off when the user 
wants to re-enable COPY to handle TRSDOS 1.3 format Model III diskettes. 
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SYS6/SYS,14,75 change 01 00 73 to 01 01 7B 

SYS6/SYS,14,C8 change 01 00 40 4E 01 13 00 to 01 13 40 4E 01 00 00 

SYE6/SYS,20,EA change 61 C8 5E to 61 C9 5E 

******** ZAP 014 ******** 08/ OB/ 81 ******** V2M1 ******** 

Mandatory zap to correct an error in BASIC that was causing SYNTAX error to 
occur when the short editing codes A, D, E and L were being used. This error 
vas introduced into BASIC just before Version 2 release in the correction of 
another but more trivial error. 

SYSlB/SYSjOZ^l change 

2C D7 28 06 FE 3D 20 F9 18 23 El to 2C CD CF 65 28 27 FE 0D 20 F7 El 

BASIC/ CMD, 14 ,08 change 00 00 00 00 00 to 23 7 E FE 3D C9 

******** ZAP 015 ******** 08/18/81 ******** V2M1 ******** 

Mandatory zap to correct error in format 5 COPY where the BOOT sector was not 
receiving the correct directory starting lump number if this differed from the 
FDRIVE specification. The error, would manifest itself by directory read error 
in DIR. 

SYS6/5YS,05,96 change 64 01 00 01 18 to 64 CD 80 50 18 

SYS6/5YS,15,46 change 

00 00 00 00 00 00 00 00 00 00 00 00 DO 00 to 

01 00 01 B7 CO 13 13 1A 32 BC 64 IB IB C9 

******** JAP 016 ******** 08/18/81 ******** V2M1 ******** 

Correct error in PDRIVE causing SYSTSt PROGRAM NOT FOUND error when the second 
drive number is specified wrongly as greater than 9. 

SYS 16/ SYS, 00, 6 A change C3 1A 52 CB to C3 4B 50 CB 

******** zap 017 ******** 08/18/81 ******** V2M1 ******** 

Mandatory zap to correct error in COPY and FORMAT where DDSL parameter was 
being erroneously rejected, 

3YS6/SYS.01.FA change CB 70 20 to CB 52 20 



• 
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******** £AP 013 ******** OB/ 25/81 ******** V2M1 ******** 

Mandatory zap to SUPERZAP to correct an error where the BM^P functions was not 
Bending the correct memory contents to the printer. 

SUPERZAF/CMD,00,04 change 

00 00 00 00 00 00 00 00 00 00 00 00 OO to 

3A 91 54 CB 5F CO 2A B4 54 22 95 54 C9 

SUPERZAP/CMD,D3,43 change 54 3 A 91 54 CB to 54 CD 00 52 CB 



******** zap 019 ******** 08/25/81 ******** y2Ml ******** 

Mandatory zap to correct next -with out- for error occuring when CEA1HBLD is 
saving a file in version 1 format and the last line starts with a /»/ sequence. 

Add to the end of line 126 of CHAlHBLD/ BAS the following eight characters: 
:G0TO130 



******** £AP 020 ******** 08/28/81 ******** V2M1 ******** 

Mandatory zap to DOS to allow ROUTE of the display to cause the BASIC PRINT of 
a numeric value to not output the value twice, 

SYS0/SYS,07,E6 change 28 39 CD to 28 5D CD 

SYS0/SYS,08,1F change 

C9 
23 7E 23 66 6F 7C B5 C& 7E BB 23 20 02 7E BA 23 
20 EE E5 D5 C5 7E AD 23 23 23 5E 23 56 D5 DD El 
7A B3 C4 D4 03 Cl I>1 El CB 40 28 D4 B7 28 Dl C9 
CD 

to 

C9 
7E BB 23 20 02 7E BA 23 20 1A E5 D5 C5 7E A0 23 
23 23 5E 23 56 D5 DD El CD DA 03 Cl Dl El CB 40 
28 02 B7 CO 23 7E 23 66 6F 7C B5 20 D3 C3 F8 4C 
CD 

5Y50/ SYS, 10,08 change 

C9 00 00 00 00 00 00 00 00 to C9 CB 40 CO 79 C9 A4 4B 00 

SYS 14/ SYS ,02, 7 4 change 43 00 00 43 to 43 FC 4C 43 



******** ££p 021 ******** 08/28/81 ******** V2M1 ******** 

Mandatory zap to BASIC to correct error during marked item and fixed item file 
processing causing strings greater than 127 characters to be written errone- 
ously and I GEL expressions of the form (len)j and (len}$ to ma 1 function, 
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BA5IC/CMD,11 ,18 change CD El 61 79 DD to CD D4 65 DO DD 

BAS1C/CMD,14,DD change 

00 00 00 00 00 00 00 to C5 CD El 61 7 9 CI C9 



******** 2ap 022 ******** 08/28/81 ******** V2M1 ******** 

Mandatory zap to EDTASM to cause the cursor display to be forced every time the 
* prompt lb displayed* waiting for the next command* This allows the cursor to 
be turned back on after a return from the DEBUG 123 function, which turns it 
off. 

EDTASM/ CHD ,05, 12 change CD 39 59 QE to CD 00 57 0E 

EDTASM/CMD,03,1A change 

40 7D E6 3F CO 11 CO FF 19 C9 to 40 CD 39 59 3E 0E C3 39 59 C9 



******** zap 023 ******** 08/28/81 ******** V2M1 ******** 

Mandatory zap to DOS to ease some of the problems caused by the fact that 

NEWDOS/80 Version 1 always used a granule lockout table in the directory GAT 

sector whereas Vera ion 2 many times does not, leaving that part of the GAT 

sector for use by the extension for the free/allocated table. Early in the 

development of Version 2, the role was that if the FDRIVE specification for GPL ^ 

vas greater than 2, then the lockout table was not used. Later on, the rule Mm 

was changed to be if the number of lumps is greater than 60H (96 decimal) or if ^W 

relative byte 60H of the GAT sector = 0FFH, then the lockout table is not used. 

Some code in 5¥S6 vas not changed to reflect this rule change* causing either a 

lock out table to not be created or to not be properly extended when the 

destination diskette has more granules than the source diskette* This change 

corrects this. However, users are warned that diskettes with GPL greater than 

2 (such as 8 inch or double sided, single density 5 inch diskettes coming from 

Version 1) converted previous to this zap may have trouble with DIRCHECK* on 

either Version 1 or 2 , complaining that one or more granules are locked out but 

free or locked out but allocated to a file. The diskettes can still be used as 

it is only DIRCHECK that has the problem, but sooner or later the diskettes 

should be re-copy ied using CBF with FMT so this lockout table conflict will be 

straightened out and DIRCHECK will stop complaining* 

SYS6/SY5*10,0A change 

3A CA 59 FR 02 CO 7D to 3A C6 59 FE 61 DO 7D 



******** zap 02 A ******** 08/30/81 ******** V2M1 ******** 

Mandatory zap to DOS to: 

1 , Correct error in format 5 and 6 COPY where destination verify error 
vas causing erroneous END OF FILE ENCOUNTERED or IKPUT PAST END error to 
be triggered for the next sector. 
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4. When the COPY command completes successfully and the system has 
returned to NEWDOS/80 READY, mount the destination diskette on drive and 
press RESET, The NEwTK)S/80 system on that double density, single sided 
diskette is now the system. 

5* Perform a DIR command to ascertain the extra granules are avail- 
able. Then execute PDRIVE, to observe that the specifications for 
drive are now single sided, double density with track reserved for 
opposite density. Please note that the specifications for drives 1 
through 9 have not been changed. If they are to be changed, you must do 
it, studying carefully the PDRIVE command, see section 2.37 

2. To make a double sided, single density NEWDOS/80 Version 2 system diskette* 

1. Make a copy of the NEWDOS/80 Version 2 master diskette. When done, 
mount that copy of the NEWDOS/80 Version 2 system in drive and press 
RESET. 

2. Execute the . following DOS command: 

PDRI VE , ,6 , TI=A, TD-C , TC=40 , 5PT-20 

This changes the specifications for drive 6 to be 5 inch, single sided, 
single density, 40 tracks. If you wish other than 40 tracks, change the 
TC parameter above to the desired track count, 

3. Place a write protect tab on the system diskette you have just 
changed. 

4. Execute the following command 

COPY ,0,0,, USD ,FMT , DPDH=6 

The source and system diskettes are the same and are the one with the 
write protect tab. The destination diskette is the one to contain the 
double sided, single density NEWDOS/80 Version 2 system. If you have two 
drives available, you may use COPY, 0,1 , (USDjFMT.DPEN^ instead. The 
destination must be on drive 1 if it is to have more than 40 tracks (when 
the COPY is finished, that drive can be made drive 0). 

5. When the COPY command has completed successfully and returns to 
NEWDOS/80 READY, mount the destination diskette in drive and press RESET 
to bring up the double aided, single density system. Perform DIR . and 
PDRIVE, as discussed above to observe the changed system. Proceed with 
additional PDRIVE re-specifications, if necessary. 

3. To make e double sided, double density NEWDOS/80 Version 2 system diskette. 

1. You must have an excellent working Per com or LNW double density 
interface in your expansion interface, 

2. Proceed as for single sided, single density discussed above excepting 
that the PDRIVE command is 
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PDRIVE ,0 , 6 ,TI-CK , TD-G, TC-3 9 ,SPT«3 b ,GPL«2 , DDCA-2 



This lb for a 40 track drive, for 35 use TC-3 4, for BO use T079, 
Further : 



1. For a destination drive more than 40 tracks use GPL-8 and you 
vill probably want as expanded directory, say DDGA-6 for maximum 
size, giving 224 directory entries* However, if any of GPL, DDSL or 
DDGA are different between the source and destination drives during 
COPY or if the number of sectors, granules or tracks for the destina- 
tion diskette is less than the source diskette, the CBF (Copy By 
File) parameter must be specified in the COPY command (example: 
COPY, 0,0,, USD, FMT,DPDN-6, CBF ). So, in the case here for drives 
over 40 tracks, since the GPL is different (the source's GPL is 2 and 
the destination's GPL is now 8), you must use the CBF parameter. 
Actually, you could have used the CBF option in any of the COPY's 
mentioned above in this zap, but CBF runs slower and should only be 
used where necessary. 

2. For UTtf interface, you can specify II flag E instead of flag C 

( example t TI-EK instead of Tt-CK)(if any & inch drives are to be used 
with the LNW, E must be specified instead of C). However,, remember , 
flags E and C are interdrive mutually exclusive; so if you change one 
of the 10 drive specs from using flag C to using flag E, you must 
change any of the other a that use flag B or C (see next section). 

4, Users setting up their systems to use the & inch drives through the OMIKROn 
interface (TI-BH) are experiencing trouble vith the P DRIVE error code **** n* 
SPEC BETWEEN DRIVES INCOMPATIBLE. Please refer to the last two sentences of 
the Tl-typel paragraph in the middle of page 2-34. If any drive's Tl speci- 
fies flag B, then no other can specify either flag or E. You must change the 
PDRIVE specifications for drives 4, 6, 8 and 9 as they conflict with flag B< 
To do this, simply execute the DOS cosmtands 

PDRIVE, 0,4-0 
PDRIVE, 0,6-0 
PDRIVE, 0,8-0 
PDRIVE, 0,9*0 

Remember, you should not make any PMIVE changes to the NEWDOS/80 Version 2 
master diskette; perform the changes on working copies of it. 



******** ZAP 030 ******** 09/02/81 ******** V2H1 ******** 

Information only. 

1. Chapter 12 failed to make it clear that though diskettes are content 
interchangeable under NEWD0S/80 Version 2 between the Model I and Model III, 
there, is a problem dealing with a format control byte for directory, sectors of 
single density diskettes. Carefully read SYSTEM options BK and BH (even though 
you have only Model III) on page 2-49, HRDIRP command on page 2-52 and the W 
function of DIRCHECK on page 6-14. 
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1. For Model III NEWDOS/80 Version 2 users, single density diskettes 
coining from the model I can be processed on the Model III by setting 
SYSTEM option BK-Y, setting up the proper single density PDRIVE and then 
for each such diskette, execute once either the DOS command WRDIRP or the 
W function of DIRCHECK. After this is done, the diskette can be used as 
any other diskette under Model III NEWDOS/80 Version 2. Subsequently, 
this diskette can not be processed by the Model I TRSDOS 2.3, but it can 
be processed by the Model I NEWDOS/80 Version 1 provided the format of the 
diskette is not changed to one of the variety of formats available on 
Version 2 but not available on Version 1). However, once this diskette is 
used back on the Model I NEWDOS/80 Version 1 and a directory sector is 
updated, the diskette cannot be reused on the Model III without performing 
again the WRDIRP or DIRCHECK function on that diskette on the Model III 
(remember, NEWDOS/80 Version 1 does not have either of these two 
functions) . 

2. For users that have NEWDOS/80 Version 2 for both the Model I and III 
and wish to use single density 5 inch diskettes interchangeably between 
the model I and model III, set SYSTEM options BK=Y and BN=Y on the Model I 
and BK=Y on the Model III. Then, for each such single density diskette, 
execute once either WRDIRP or the W function of DIRCHECK. This can be 
done on either the Model I or III and all such diskettes do not have to be 
done at the same session. Each such diskette can now he used interchange- 
ably between the Model I and Model III under NEWDOS/80 Version 2 (don't 
forget the proper PDRIVE specifications), but the diskette cannot be 
processed by TRSDOS 2.3 

2. For BASIC function RENUM (see section 7.9 on page 7-5) the 4th and 5th 
formats listed ( RENUM X and RENUM U,X ) are not valid and should be deleted 
from the middle of page 7-5. If the X parameter is to be used, it must be 
done via the 1st format listed as X is meaningless unless specific values for 
ppppp and/or qqqqq are also specified. 

3. Some users have asked for more distinctions between full diskette COPY 
(format 5) or Copy By File COPY (format 6), both specified in section 2.14. 

1. Format 5 copies a full diskette sector by sector and is generally 
faster than format 6, which copies files individually. However, if the 
source diskette is relatively empty, format 6 may be faster. 

2. In format 5 the source directory becomes the destination directory, 
including the same size and relative sector position on the diskette, 
while in format 6, the two directories are considered separate just as in 
a format 1 through format 4 COPY. 

3. Generally, if format 5 is used, both the source and destination PDRIVE 
specifications for GPL, DDSL and DDGA must be the same (though only the 
restriction on GPL is enforced, but not if BDU is specified); the other 
PDRIVE parameters may be different provided the destination diskette is to 
have at least as many sectors as the source diskette (though the format 5 
specifications say that sectors pe* track must be the same; this is not so 
in Version 2 where it was in Version 1). 
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4. Format 5 with the BDU option allows some alien diskettes to be copied 
that otherwise could not be copied. 

5. Format 6 allows a diskette's contents to be copied between diskettes 
having a different number of granules per lump (GPL), the directories 
positioned differently on the diskettes, the directories of different 
sizes, or the destination diskette having less sectors than the source. 

6. Format 6 copies all of a source diskette's files or a selected subset 
of those files. 

7. Both format 5 and 6 allow the option of formatting the destination 
diskette (FMT) or not (NFMT) . Formatting a diskette magnetically init- 
ializes the entire diskette including the inter-sector control bytes used 
only by the drives and the controller. Many users prefer to do this 
everytime a back up is done. Of course, formatting a diskette destroys 
the previous contents. 

8. If format 6 is being used to copy a NEWDOS/80 Version 2 system disk- 
ette, the FMT option must be specified. This assures the correct BOOT, 
SYSTEM and PDRIVE control informat is Btored on the destination diskette, 
and the correct positioning of SYSTEM files which, excepting for BOOT/SYS 
and SYSO/SYS, are all positioned on the destination diskette in same posi- 
tion relative to the directory that they are on the source diskette. 

9. In format 6 where HFMT is specified, system files are NOT copied to 
the destination diskette if they are not already existing in the 
destination directory. This is because system files usually use specific 
FDEs in the directory, and only FMT can assure that these FDEs are 
available. 

10. Format 5 without BDU and format 6 with FMT both assume the possi- 
bility of the destination diskette being used later as the system diskette 
and the destination drive or one like it being used later as drive 0; 
therefore both initialize the BOOT/SYS file to contain the proper BOOT 
code and drive PDRIVE specifications. 



******** zap 031 ******** 09/06/81 ******** V2M1 ******** 

Mandatory zap to DOS to allow files to be copied from and to diskettes used by 
Model I TRSDOS 2.3B and higher as well as from and to diskettes used by Model 
III TRSDOS 1.3 or higher. After applying the documentation changes given 
below, see section 12.5.1 on page 12-7, the 'flag M' paragraph on page 2-35 
and the bottom half of page 2-15. 

This enhancement expands the definition of PDRIVE TI flag M (see page 2-35). 
When the M flag is specified and the TD field specifies double density (i.e. , 
TD-E), the PDRIVE specification is assumed for a Model III TRSDOS diskette and 
TI flag I is implied (see example 3 on page 2-38). When the M flag is 
specified and the TD field specifies single density (i.e., TD*A) , the PDRIVE 
specification is assumed for Model I TRSDOS 2.3B or higher diskette, and TI 
flag I is not implied and must not be specified (see example 1 on page 2-38 
with TI-AM) . 
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Radio Shack has started distributing certain new programs {i.e., COBOL) with or 
on Model I TRSDOS 2.3B or higher diskettes with that system being somewhat 
different than Model I TRSDOS 2.3, including the use of RBAs as discussed in 
section 12.1 for the Model III. These diskettes are NOT compatible with 
NEWDOS/80 diskettes, and, as with Model III TRSDOS diskettes, COPY is the only 
function of NEWDOS/80 that can he used with the Model I TRSDOS 2.3B diskettes 
(though FREE and DIR (except EOF and special flags) appear to work). 

Files on either Model III TRSDOS or Model I TRSDOS 2.3B diskettes that are to 
be used either by NEWDOS/80 or user programs executing with NEWDOS/80 must be 
copied to NEWDOS/80 diskettes. FORMAT or COPY with FMT option cannot be used 
to format a diskette in either the Model III TRSDOS or the Model I TRSDOS 2.3B 
format; however, format 5 COPY with the BDU option can be used to make copies 
of those diskettes. 

ZAP 013 must NOT be installed in a NEWDOS/80 to be used to copy Model I TRSDOS 
2.3B files. ZAP 013 must be used for Model III TRSDOS 1.1 & 1.2 diskettes. 

Insert the following notes in the outside margin of the specified paragraph: 

1. Page 2-9, next to last paragraph: "For Model III TRSDOS and Model I 
TRSDOS 2.3B diskettes, see ZAP 031." 

2. Page 2-15, "The COPY command" paragraph: "This section applies also 
to standard 35 track, single sided, single density diskettes for Model I 
TRSDOS 2.3B or higher." 

3. Page 2-15, "The user must" para: "See examples 1 and 3, section 2.37". 

4. Page 2-35, "Flag M" paragraph: "Expanded to include Model I TRSDOS 
2.3B or higher diskettes. See ZAP 031 

5. Page 2-38, example 1: "For Model I TRSDOS 2.3B diskettes, use TI-AM 
(see ZAP 031)." Also in this same paragraph, change the last two words to 
read "option BN" instead of AN. 

6. Page 12-7, paragraph 12.5.1: "See ZAP 031." 

SYS6/SYS,00,7D change CD B3 63 21 to CD 96 5C 21 

SYS6/SYS,15,5C change 

00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 00 00 00 00 00 
to 

CD B3 63 3A 
BE 59 47 3A B9 59 4F 3A CC 59 57 3A C7 59 5F 79 
A3 CB 6F 28 06 78 AA OF DA 47 67 78 CB 69 20 04 
CB 6B C8 7A OF D8 21 5B 5B 22 F7 55 21 Bl 5B 22 
5D 5B 21 00 5C 22 61 5B AF 32 7F 61 67 6F 22 BF 
61 22 B5 5B 3E 18 32 2D 61 C9 
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SYS6/SYS, 22.6B change CD B3 63 CD to CD 96 5C CD 

SYS16/SYS,01,F8 change 05 28 02 3E 03 CD to 05 00 C4 8D 51 CD ^^ 

SYS16/SYS,02,AF change 

CB E3 DD 7E 05 FE 06 CO to CB 43 3E 06 C4 87 51 CO 

SYS16/ SYS ,04 , 9A change 

00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 . to 

00 CB E3 DD BE 05 C9 DD CB OF 56 C8 3E 03 C9 



******** ZAP 032 ******** 09/10/81 ******** V2H1 ******** 

Mandatory zap to DOS to: 

1. prevent COPY from Betting file update flag on in Model I TRSDOS 2.3B 
and Model III TRSDOS diskettes when that bit is used differently in those 
systems. 

2. enable /ext type CBF file selection when the source is a Model 1 TRSdos 
2.3B or Model III TRSDOS diskette. 

SYS6/SYS,10,83 change C3 39 44 DD to C3 E4 5C DD 

SYS6/ SYS , 1 5 , AA change 

00 00 00 00 00 00 01 00 EA 5C 00 00 00 00 00 00 00 00 to 

3A 0C 43 CB 6F 28 01 00 EA 5C 04 DD CB 02 EE C3 39 44 

SYS6/SYS,16,F0 change 61 20 0D 3A 96 59 CB to 61 3A 96 59 20 0A CB 



******** ZAP 033 ******** 09/10/81 ******** V2M1 ******** 

Mandatory zap to correct error in SUPERZAP during the DM function and during 
the F, find function. 

SUPERZAP/CMD,00,11 change 

00 00 00 00 00 00 00 to 6B 63 4B 22 C3 54 C9 

SUPERZAP/ CMD, 05, 0B change 00 6B 63 4B CB to 00 CD 0D 52 CB 



******** ZAP 034 ******** 09/11/81 ******** V2M1 ******** 

Mandatory zap to the Ryan-McFar land Corp's COBOL version 1 .3B distributed by 
Radio Shack to allow it to run with NEWDOS/80 Version 2 for the Model I and 
Model III. This zapped version will not run under TRSDOS. Users must copy the 
COBOL multiple files onto NEWDOS/80 diskettes (see zap 031). 

RSC0B0L/CMD,99,7D change 44 24 3E 40 49 to 44 82 27 44 49 
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RSC0B0L/CMD,99,CF change 44 13 IF 44 to 44 82 27 44 

RUNC0BOL/CMD,115,82 change 

44 3E 40 49 40 24 17 to 44 27 44 49 40 82 17 

RUKC0B0L/ CMD , 1 1 5 , 99 change 

02 IF 44 11 44 13 0A to 02 27 44 11 44 82 0A 



******** 2AP 035 ******** 09/13/81 ******** V2M1 ******** 

Mandatory zap to DOS to correct a directory clobbering error that occurs when 
either CLOSE or KILL frees up a FPDE or FXDE that occupies the first FDE slot 
in a directory sector. This error was missed during BETA testing aB it was 
caused by a late adjustment to handle the TRSD0S Model III diskettes. A few 
persons were complaining about directories being clobbered, but only on 
September 12th was an error report made that lead to the discovery. Though the 
problem would appear to affect many users, apparently to date it has not. 

SYS3/SYS,01,CC change 

00 7D D6 17 BB 30 ID to 00 7B C6 16 BD 38 ID 



******** ZAP 036 ******** 09/13/81 ******** V2M1 ******** 
Information zap. 

1. Documentation correction for EDTASM. Tape I/O is KOT available for the 
Model III. If it is attempted, BAD PARAMETER(S) error will be given. 

1. Place in the outside margin of the "2. L T-nnnnnn" paragraph of page 
6-15 the following restriction: "Model I only" 

2. Place in the outside margin of the 2nd line of page 6-16 of page 6-16 
the following restriction: "Model I only" 

2. Correct the "A list of all" paragraph on page 1-3 to read "NHD80V2/ILF and 
NWD80V2/XLF" instead of "NWD82V2/ILF and NWD82V2/XLF". 

3. Delete the words "sectors per track, M from the "Format 5 is a full" 
paragraph of page 2-11. 

4. The MM-addrl function of ROUTE requires the main memory location addrl to 
be greater than 51FFH. In the "Any of the devices" paragraph of page 2-43, 
insert the words "greater than 51FFH" after the word "location" in the phrase 
"memory location of a user". 
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******** ZAP 037 ******** 09/14/81 ******** V2M1 ******** 



Mandatory zap to BIONIC BASIC to make it compatible with NEWDOS/80 Version 2 
for the Model 1. These zaps were provided to Apparat and have not been checked 
out by Apparat. One or more of the zaps may already be installed in your 
modules. When these zaps are applied, the BIONIC BASIC must not be used with 
any other version of NEWDOS/80. 



• 



FIREUP/CMD,02,51 


change 


3A 31 0D to 3A 30 0D 


" ,04,90 


change 


21 86 63 22 to 21 FC 61 22 


" ,05,3C 


change 


40 09 58 01 to 40 FF 57 01 


" ,05,40 


change 


05 28 65 to 05 86 65 


" ,05,4E 


change 


05 30 5F to 05 8E 5F 


" ,05,55 


change 


05 60 5F to 05 BE 5F 


" ,05, 5C 


change 


05 CF 64 21 to 05 2D 65 21 


" ,05,63 


change 


05 BE 64 21 to 05 1C 65 21 


" ,05,6A 


change 


05 95 64 to 05 F3 64 


INSTALL/ CMD, 01 ,0D 


change 


3A 31 0D to 3A 30 0D 


H ,01, 4F 


change 


44 C8 FE to 44 C9 FE 


REMOVE/ CMD, 01, 12 


change 


3A 31 0D to 3A 30 0D 


" ,01,54 


change 


44 C8 FE to 44 C9 FE 



******** zap 038 ******** 09/14/81 ******** V2M1 ******** 

Optional zap to Model I SCRIPSIT to eliminate the 'hang' occuring when the END 
function is executed and the last disk 1/0 was to a double density drive. 
SCRIPTSIT executes the END function by jumping to location 0, causing a 
software but not a hardware RESET. The double density modifications to the 
expansion interface require a hardware RESET to reset them to the single 
density disk I/O assumed by the software RESET in the ROM. SCRIPSIT uses the 
RESET to restore the keyboard, display, printer and other interfaces it has 
changed. If the Z-80 HALT instruction is executed instead of a jump to 
location 0, the Model I (this does not hold for the Model III) hardware RESET 
is triggered which in turn triggers the software RESET. In both cases, either 
the jump to or the HALT, the red lights on the disk drives must be off. The 
zap is applicable under TRSDOS as well as all versions of NEWDOS, 

SCRIPSIT/LC,19,E3 and SCRIPSIT/UC,19,E3 
change 6F C3 00 to 6F 76 00 



******** 2AP 039 ******** 09/24/81 ******** V1M1 ******** 

Mandatory zap to PENCIL to enable it to run with NEWDOS/80, version 2. This 
zap is an extension of zaps 002 and 026. We apologize for the large number of 
zaps to PENCIL, but Apparat doen't use PENCIL and so must rely upon the users 
to find the discrepancies. 



PENCIL/ CMD, 03, 25 



change 53 36 A0 CI to 53 CB FE CI 
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******** ZAP 040 ******** 09/29/81 ******** V2M1 ******** 

Mandatory zap to DOS to correct rare occuring error that could, if the same HIT 
code is used more than 31 times in a directory, cause file open to not find a 
file and to put two files with the same name/ ex t on the diskette. 

SYS2/SYS,01,CB change FE CD 28 to FE CC 28 



******** zap 041 ******** 09/29/81 ******** V2M1 ******** 

Information and manual corrections. 

1. A number of users have had trouble with tape I/O under NEWDOS/80 Version 2, 
Some of the early copies of NEWDOS/80 Version 2 had errors due to undetected 
RAH errors during duplication and in maybe as many as 20 cases this affected 
the EDTASM or I210FFSET module. However, if these modules were bad, they 
usually also had problems with disk 1/0 as well as cassette I/O and so if disk 
I/O works fine, we assume it is not a bad copy of NEWDOS/80. Tape I/O has long 
history of trouble, varying from computer to computer and especially from tape 
unit to tape unit such that any particular tape will fail on somebody's 
cassette unit. This has always been an exasperating problem and the main 
reason why cassettes are not used at Apparat (though we do act as a retailer/- 
distributor for products distributed on cassettes produced by others). Because 
cassettes are not used at Apparat, NEWDOS receives very little testing with 
cassettes, and in the future we are considering withdrawing all support (i.e., 
LMOFFSET and EDTASM) from cassettes. Cassette support for EDTASM for the Model 
III has already been withdrawn and will probably soon be withdrawn for the 
Model I (since the purpose of our EDTASM was to give disk support, not cass- 
ette). For now though, we will restrict our error study to those problems 
presented to us on a diskette containing the actual NEWDOS system used. If the 
user presents us with a cassette along with the diskette we will test that as 
well; otherwise we will test with simple programs from disk in-house. Neither 
the diskette nor the cassette will be returned to the user. Lastly, if you can 
avoid use of cassettes, DOI1III 



2. The specifications for ROUTE using the MM=addrl operand are in error in the 
manua 1 . 

1. Page 2-43, 3rd paragraph, 3rd line, change "12" to "16". 

2. Same paragraph, 5th line, change "13th" to "17th". 

3. Page 2-44, top line, change "0FE8CH" to "0FE90H". 

3. A number of users has asked why Automatic Density Recognition (ADR) was not 
used in NEWDOS/80 Version 2. We wanted to included ADR but found it 
impractical unless we limited or expanded other capabilities made available by 
PDRIVE. Since we were already two months late in releasing Version 2, we 
decided to release without it. Part of the problem is in providing a second 
SPT parameter and an extra indicator for track useage (remember, Version 2 
operates with double density diskettes that may or may not have track 
reserved for single density). We also felt that if We included ADS, we should 
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also include ASR (automatic side recognition). For now, we will remain without 
ADR and ASR, but will not rule it out for a subsequent NEWDOS/80 version. 



4. For BASIC CMD "0" and multi-dimensional arrayB , a few users have aBked for 
clarification of term REN used in the documentation for on pages 7-14 through 
7-17. CMD"0" does not care whether an array is single or multi-dimensional as 
CMD"0" only concerns itself with the relative positioning in main memory 
between array elements and not with the actual subscripts for a given element, 
except for determining the main memory position of the first element 
participating in the sort as specified in the CMD "0" statement. As an aide to 
the programmer to understand the sort order, a formula was given for two and 
three dimensional arrays to determine the REN of any array element given its 
subscripts. The following working BASIC program demonstrates the relationship 
between REN and subscripts for a three dimensional array, using Rl, R2, R3, XI, 
X2 and X3 to correspond with the useage at the bottom of page 7-14 and top of 
page 7-15. 

10 Rl-3: R2-4: R3-2 : DIM A(R1 ,R2,R3) 

20 REN-0: FOR X3-0TOR3 : FOR X2-0TOR2: FOR X1-0TOR1 'CREATE ARRAY IN REN 

ORDER 

30 IF REN <> X1+X2*(R1+1)+X3*(R1+1)*(R2+1) THEN PRINT" ERROR": STOP 

35 ' THE ABOVE ASSURES THE FORMULA COMPUTES TO THE CURRENT REN NUMBER 

40 A(X1,X2,X3)-REN: REN-REN+1 : NEXT X1,X2,X3 'STORE THE REN NUMBER IN THAT 

ELEMENT 

50 CMD"0",0,A(0,0,0) 'SORT ARRAY IN ASCENDING NUMERIC ORDER 

60 ' THE ARRAY ORDER SHOULD NOT HAVE BEEN CHANGED. 

70 FOR X3-OTOR3: FOR X2=0TOR2: FOR Xl=0TORl 'LIST ARRAY IN SAME ORDER 

STORED 

80 PRINT A(X1,X2,X3);: NEXT X1,X2,X3 'AND THIS SHOULD BE ALSO THE SORTED 

ORDER 

Elements with one or more zero subscripts do participate in the sort if that 
element is within the main memory range of elements sorted, i.e., has a REN 
greater than or equal to the REN of the 1st sort element and less than or equal 
to the REN of the last sort element. 



5. Correct the last paragraph of page 2-27 by deleting the 3rd sentence and 
changing the 4th sentence to read "Hex codes less than 20H or greater than the 
SYSTEM option AX value will be displayed as periods. 1 '. 

6, A number of users having CPU speed up modifications in their computers and 
setting the slow-down-during-I/O switch have complained that NEWDOS/80 
continuously toggles the fast/normal CPU speed state (in many cases a light 
flickers on/off or red/green). Indeed this is true. In the original TRSD0S, 
there were 8 interrupts, 0-7, of which only 6 and 7 were used. Interrupt 6 
only read the disk controller status register; so NEWDOS/80, to save resident 
DOS space which is critical, combined interrupt 6's function with interrupt 7, 
reading the controller status register every 25 ms interrupt. Though the 
fast/normal CPU toggling is interested only in the controller command register, 
the hardware connection actually toggles on both the read of the status 
register and the write of the command register. Normal disk 1/0 cannot operate 
without the status register read when the controller has interrupt status; so 
we cannot eliminate the interrupt 7's read of the status register without 

ZAPS (PATCHES) 13-20 



re-enabling interrupt 6 and we don't have the patch space for that. Therefore, 
users must turn off the switch on their computers that allows the fast/normal 
toggling to take place, and simply use the fast speed all the time (be sure 
SYSTEM option BJ is set correctly). There is no guarantee that your computer 
will actually work at the faster speeds. Doubling the CPU speed seems OK; 
tripling appears HOT. The LNW computer at 2.5 times the TRS-80's normal speed 
is reported by LNW to work fine. 



******** 2AP 042 ******** 09/30/81 ******** V2M1 ******** 

Mandatory zap to correct error in BASIC s RENUM function giving SEQ # OVERFLOW 
when large programs, say over 26,000 bytes of text, are renumbered. Though a 
number of users called on this problem, it -wasn't -until a user sent us a 
written error report with the problem program on a system diskette that we 
finally had enough to go on. 

SYS11/SYS,03,BB change OF ED 42 DF 38 to OF CD 9D 51 38 

SYS11/SYS,04,A5 change 00 00 00 00 00 to ED 42 D8 DF C9 



******** 2AF 043 ******** 10/07/81 ******** V2M1 ******** 

Mandatory zap to DOS to correct omision from ZAP 020 (ROUTE) which caused 
SYSTEM option BA to cause hang on reBet. 

SYS0/SYS,00,BF change FF 00 00 00 to FF FC 4C 00 



******** zap 044 ******** 10/07/81 ******** V2M1 ******** 

Mandatory zap to DOS to disable SYSTEM option BM. SYSTEM option BM=K caused 
the full diskette verify to be bypassed when the user felt the track verify 
that occurred immediately after a track was formatted was sufficient. However, 
if the user is formatting more tracks that the drive can physically handle, 
FORMAT with SYSTEM option BM»N will not detect the error whereas it will with 
SYSTEM option BM=Y. Therefore, SYSTEM option BM is dropped, and the full 
diskette verify will always be done. 

On the outside margin of the BM=yn paragraph of page 2-49, write the following: 
"eliminated by ZAP 044". 

SYS6/SYS, 10,35 change 

El 3A 6D 43 CB 5F C8 3E to El 00 00 00 00 00 00 3E 

SYS17/SYS,02,55 change FE 31 7A to FE FE 7A 
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******** ZAP 045 ******** 10/07/81 ******** V2M1 ******** 

Mandatory zap to correct BASIC function REF$ to (1) avoid occasional misses of 
printer line advance and (2) disable printer operations after the function. 

SYS12/SYS,04,BA change FE 38 30 to FE 35 30 

SYS18/SYS,03,57 change D2 B5 57 3D to D2 59 55 3D 

SYS18/SYS,03,69 change 00 00 00 00 00 to 11 45 64 D5 EF 

******** 2AP 046 ******** 10/09/81 ******** V2M1 ******** 

Optional zap to DOS to allow ' JKL' to print graphics on the EPSOM printers that 
use graphic codeB 0A0H - 0DFH. This is done by converting hex codes 80H 
through 0BFH to 0A0H through 0DFH. 

SYS3/SYS,04,BF change 30 02 3E to 30 07 3E 

SYS3/SYS,04,C8 change 

00 00 00 00 00 00 00 00 to FE 80 38 F7 C6 20 18 F3 

Use next zap if 0BFH rather than SYSTEM option AX is to govern as high ASCII 

for JKL. 

SYS3/SYS,04,B9 change 47 3A 70 43 B8 to 47 00 3E BF B8 



******** ZAP 047 ******** 10/21/81 ******** V2M1 ******** 

Mandatory zap to correct DOS handling of 8 inch, double density, single or 
double sided, single volume drives (PDRIVE TD-H) where the computer hardware is 
modified to handle double CPU speed and 8 inch, double density, single or 
double Bided, single volume operations. The PDRIVE SPT maximum values are 30 
for single sided and 60 for double sided. The PDRIVE GPL must be atleast 3 for 
single sided and atleast 5 for double sided; however 8 is recommended in both 
cases. This zap does NOT mean that your particular computer can handle this 
type of drive. However, LNW reports the UIDOUBLER 5/8 (CPU speed up 
modification required) and the LNW80 computer systems both support 8 inch 
double density under NEWDOS/80, Version 2 (also see zap 041 part 6). 

SYS6/SYS,27,BD change E6 41 DD to E6 CI DD 

SYS6/SYS.31 F5 change 

34 0A 26 0A 86 01 9C 27 44 00 to 13 0A 14 0A 53 01 BA 27 26 00 

SYS16/SYS,04,2D change 12 1A 24 34 82 to 12 IE 24 3C 82 
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******** ZAP 048 ******** 10/21/81 ******** V2M1 ******** 

Mandatory zap to EDTASM to correct error occurring when shif t-lef t-arrowis 
used to erase a filespec response. 

EDTASM/CMD, 31,00 change 

58 C5 CD 2F 59 El E5 3A AA 53 F5 0E 01 CD 47 5B Fl 32 AA to 

58 D5 C5 CD 2F 59 El 06 IF CD 40 00 DA D7 58 Dl 7E C9 AA 



******** zap 049 ******** 11/09/81 ******** V2M1 ******** 

Mandatory zap to DOS to correct error in DIR $ or DIR $0 command where DOS 
hangs if any response other than ESTER is given to the diskette mount requests, 

SYS8/SYS,02,B8 change 20 FC C9 to 20 F9 C9 



******** 2AP 050 ******** 11/09/81 ******** V2M1 ******** 

Optional zap to DOS to allow the DOS PRINT and LIST commands to accept all 
control characters in the hexidecimal range 00 to IF instead of just 0D (end of 
line). If this zap is used, ueers must assure that files used with PRIKT and 
LIST do not contain control characters the display or printer cannot handle. 
Remember, the high bit of all characters is zeroed, thus display graphic 
characters 80 - 9F will be transmitted as 00 - IF. 

SYS14/SYS,04,5A change 20 DO FE to 20 C9 FE 



******** ZAP 051 ******** 11/09/81 ******** V2M1 ******** 
Information zap. 

1. Users must remember that the Model I TRSDOS 2.3B or higher and Model III 
TRSDOS 1.3 or higher, amongst other things, both went to using RBAs in the NEXT 
and EOF fields of the FCB, thus intentionally or unintentionally restablishing 
compatibility with NEWD0S21 and HEWDOS/80 in the use of those two fields (which 
many user programs use), even though the EOF fields in the directories (which 
most user programs don't use) are now incompatible. Though files from those 
systems must be copied to KEWDOS diskettes, assembly language programs upgraded 
to run with those TRSDOS systems are more like to run with HEWDOS without 
change then they were before. For example, on the Model III, SCRIPSIT Version 
3.2 has been found to work as-is. So, before calling Apparat to see if zaps 
exist for a given program, try it out, giving special attention to the file 
I/O. 

2. The manual failed to explain that when SYSTEM option AJ»N or when the 
up-arrow key is held down during reset/ power-on, DOS loses the abliiiy use the 
lower case driver (Model I only) or to actually input keyboard e^racters from 
the chain file during chaining as these functions depend upon DP^'s keyboard 
intercept routine being enabled. SYSTEM options AD-N and BF-tf {Model I only) 
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and are also forced. DOS will think it is activating chaining, but actually 
the input characters will continue to come from the keyboard; the DOS READ? 
prompts will not be seen as DOS thinks it is chaining. For LCDVR (Model I 
only), the command will execute but the key input functions for lower case 
drive will not be done. Insert the note "see ZAP 051, part 2" in the outside 
margin at the following places in the manual. 

1. Page 2-7, the "CHAINING is discussed" paragraph. 

2. Page 2-29, the "In NEWDOS/80" paragraph. 

3. Page 2-47, the "AJ=yn" paragraph. 

4. Page 4-9, the "If a DOS recognized" paragraph. 

3. Chain files must always have a name-extension. When creating a CHAIR file, 
you must always specify a name-extension in the filespec, excepting that 
CHAINBLD/BAS will assume name extension /JCL if you don' t give one. If the 
filespec given in a DO or CHAIN command does not specify a name-extension, then 
/JCL is assumed; therefore it is recommended that the name-extension /JCL be 
used on chain files when created. Place the note "See ZAP 051, part 3" in the 
outside margin in the following places in the manual. 

1. Page 2-7, the "When the system" paragraph. 

2. Page 4-8, the "Chain file creators" paragraph. 

4. For Model I SCRIPSIT where the user wishes to use tape I/O, the user must 
back off the last zap of ZAP 003 (the SCRIPSIT/xx,00,C3 zap) in order that 
interrupts will remain disabled, a requirement for Model I tape I/O. This 
means the user cannot invoke MINI-DOS from SCRIPSIT. 



******** zap 052 ******** 11/09/81 ******** V2M1 ******** 

Mandatory zap to BASIC to correct CLOSE without explicit fan(s) where filearea 
2 and up was not being closed if filearea 1 was not open and the V parameter 
was specified in the BASIC invocation sequence. 

BASIC/CMD,08,C8 change 66 11 2D 01 7E to 66 CD DB 65 7E 

BASIC/CMD,14,E4 change 00 00 00 00 00 to ED 5B C5 64 C9 



******** zap 053 ******** 11/09/81 ******** V2M1 ******** 

Part mandatory and part optional zap to MICROSOFT'S BASIC compilier Version 
5.23 (the release Version for a long time)(the first line a /LST file created 
by the compilier gives the compilier version number) to allow it to run with 
NEWDOS/80. This zap has been provided to Apparat by MICROSOFT and if there are 
questions with this zap, please contact MICROSOFT. Once these zaps are 
applied, this compilier and the compiled programs cannot be used with TRSDOS 1 1 1 
Future enhancements to the compilier may require the optional changes below to 
be backed off; therefore users should maintain copies of the compilier (1) as 
it existed before the mandatory changes below were applied, (2) after the 
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mandatory changes but before the optional changes below are applied and (3) the 
final result. Also, remember, the BASIC compilier's L80/CMD is not for use 
with FORTRAN, assembler, etc., but only with BASIC. 

The production of this zap required a large amount of research and testing by 
MICROSOFT, and APPARAT sincerely thanks MICROSOFT for this extensive effort to 
make the BASIC compilier operate with NEWDOS/80, Version 2. 

****** Mandatory section 

BRUN/CMD,10,1D change 46 OB 70 to 46 00 70 

******* Optional section 

The following optional zaps are for: 

1. The LOF function is changed to work like NEWDOS/80, rounding up the 
returned value if EOF is not integer divisible by the logical record 
length used in the OPEN statement. Further, if the result exceeds 32767, 
BAD RECORD NUMBER error results. 

2. PUT and GET without explicit record number works correctly. 

3. LOC functions correctly for the logical record length in the OPEN 
statement. 

DIR/SYS,xx,yy Search the directory for BRUN/CMD's directory entry, the 
associated line on the SUPERZAP display should look something like this: 

1020 0062 0042 52 55 4E20 2020 2043 4D44 . . .b.BRUN. . . .CMD 
change the 62 (the 4th) byte to F6. 

BRUN/CMD,40,4A change 

21 0C 00 09 5E 23 56 EB Dl CI C9 CD to 

DD 21 6E 8A CB 23 DD 19 C3 2E 8A CD 

BRUN/CMD,40,63 change 00 C3 AD 79 El to 00 C3 37 8A El 

BRUN/CMD,40,B3 change C5 21 0C 00 09 to C5 C3 00 8A 09 

BRUN/CMD,40,CE change IB 42 4B to CD 11 8A 

BRUN/CMD,42,7F change CD 17 58 to CD IB 8A 

BRUN/CMD,56,84 change 02 02 00 52 (the rest is immaterial) 
to 

016D 008A CB23 DD21 6E8A DD19 
DD5E 00DD 5601 C317 7ADD 7300 DD72 011B 
424B C9C5 CB21 DD21 6E8A DD09 DD70 00DD 
7001 C1C3 1758 DD6E 00DD 6601 D1C1 C9C5 
DDE1 DD6E 0ADD 660E DD5E 0FDD 4E0B AFB9 
281D AF06 18ED 6ACB 1317 9130 0181 3F10 
F4ED 6AB7 2801 23D1 C1CB 7CC8 C39A 7D6C 
6318 F402 0200 52 

L80/CMD,0O,7A change 00 8A 22 to 00 8B 22 
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Note, the above zap to L80/CMD changes the default data address for compilied 
BASIC programs from 8A00H to 8B00H to allow an extra 256 bytes for BASIC system 
use. If the -R switch is issued during the linking process, the -D Bwitch must 
be reset to 8B00 instead of 8A00 as mentioned in the compilier manual. 



******** zap 054 ******** 11/19/81 ******** V2M1 ******** 

Mandatory zap to EDTASM correct error in object code write to tape where 
checksums were being computed wrong. The HEWDOS/80 author apologizes to the 
ten or so persons who complained of this error over the last 4 months. 

EDTASM/CMD.27,30 change CD A9 70 03 to CD 8B 72 03 

EDTASM/ CMD, 3 1,1 2 change AA 53 36 00 El 7E to F5 CD A9 70 Fl C9 



******** zap 055 ******** 11/19/81 ******** V2M1 ******** 

Optional zap to DOS to allow the PATCH LC keyboard modification to work with 
NEWD0S/80 Version 2. 

SYS0/SYS,02,34 change 

2E 36 01 01 38 16 FF 0A 5F AE 73 A3 

20 0D 7A C6 08 57 2C CB 01 F2 4A 45 AF 18 OF 5F 
to 

2E 35 01 80 38 16 F7 7A C6 08 57 2C 

CB 01 0A 5F AF CB 79 20 15 7B AE 73 A3 28 EC 5F 



******** ZAP 056 ******** 11/29/81 ******** V2M1 ******** 

Mandatory zap to DOS to allow COPY with CBF option to allocate space on Model 
III TRSDOS diskettes beyond track 23. 

SYS6/SYS,25,F0 change CD B2 4C DD to CD F2 5C DD 

SYS6/ SYS , 1 5 ,BC change 

00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 to 

DD CB 02 6E 28 04 DD CB 07 46 CA B2 4C 3E 03 C3 B4 4C 



******** ZAP 057 ******** 11/29/81 ******** V2M1 ******** 

Mandatory zap to DOS to correct directory errors created during format 5 COPY 
when copying to a destination diskette that is to contain more granules than 
the source diskette and when the source diskette has less than 61H (97 decimal) 
lumps and the destination diskette is to have more than 60H (96 decimal) lumps. 
In KEWD0S/80 Version 2, in order to allow a maximum of C0H (192 decimal) lumps 
in the granule allocation table, that table (normally in 00 -5F of the GAT 
sector) expands into and supercedes the granule lockout table (normally in 60 
-BF of the GAT sector. This error was leaving the GAT granule lockout table in 

ZAPS (PATCHES) 13-26 



existence in the destination directory (remember, it is transferred over from 
the source diskette in format 5 COPY) when it should have been done away with 
to make room for the expanded granule allocation table. The error is 
immediately detectable by DIRCHECK after the format 5 COPY by the presence of 
one or more BAD "GAT" SECTOR BYTE errors. Otherwise, the error is not seen 
until TRACK # TOO HIGH error occurs when writing to the diskette and a granule 
beyond those allowed for the diskette is erroneously allocated; the file 
getting the error will NOT have had its EOF increased to include the erroneous 
sector. DIRCHECK will, in addition to the GAD "GAT" SECTOR BYTE errors, then 
display EXTENT SPACE OVERFLOWS DISKETTE for that file, but since EOF does not 
include that bad granule, single file COPY or format 6 COPY will still be able 
to copy the file. Therefore, any bad diskettes should he recoverable by using 
a format 6 COPY with FMT option to copy the contents of the bad diskette onto 
another diskette. You can then use either format 5 or 6 COPY with FMT option 
to copy it back. 

This zap is large as part of SYS6/SYS is being moved to SYS17/SYS to make more 
patch area available in SYS6/SYS. 

SYS6/SYS,07,79 change 52 CD 35 55 ED to 52 C3 1C 50 ED 

SYS6/SYS, 21,85 change 3E E6 28 to 3E F3 28 

SYS17/SYS,00,0C change 2A C2 81 4E 78 to 2A CO 00 00 78 

SYS17/SYS, 03.2C through 9E was all zeroes, change to 

CD 35 55 ED 

5B CI 59 CD 84 57 ED 4B 94 59 CB 49 20 5E CD F9 

56 IE 61 3A C6 59 BB 38 0E 3A B8 59 BB 30 08 ID 

6B 36 FF ID 23 20 FA CB 68 28 06 2A 81 59 22 CE 

42 79 E6 OC 01 10 00 11 DO 42 21 83 59 20 07 21 

SB 59 IE D8 OE 08 ED B0 2A Dl 59 ED 5B C3 59 B7 

ED 52 EB 38 11 28 OF 2A C3 59 3A BC 59 CD B4 4C 

26 42 4F CD 62 57 CD IF 49 C2 CB 54 C3 2D 55 

******** ZAP 058 ******** 12/01/81 ******** V2M1 ******** 

Mandatory zap to I210FFSET to correct error occuring when a object code block's 
load point iB in the range 3F00 to 3FFFH. 

I«OFFSET/CMD,01,36 change 78 05 85 to 78 3D 85 

******** 2AP 059 ******** 12/28/81 ******** V2M1 ******** 

Mandatory zap to correct 3 bytes wrong in ZAP 054 (EDTASM), if not already 
corrected. The entire correct zap is given here. The corrections are to 
change to two occurrences of EB in the let part to 03 and the occurrence of 30 
in the 2nd part to 31. 

EDTASM/CMD,27,30 change CD A9 70 03 to CD 8B 72 03 

EDTASM/CMD,31,12 change AA 53 36 00 El 7E to F5 CD A9 70 Fl C9 
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******** ZAP 060 ******** 12/28/81 ******** V2M1 ******** 

Mandatory zap to DOS to eliminate disk status register read for all interrupts 
except the disk I/O (taking NEWDOS/80 back to the original TRSDOS way). 
NEWDOS/80 read the status on every interrupt in order to eliminate some code in 
the eternal quest to make more space available in SYSO. This worked fine until 
CPU speed up hardware modifications were devised that shift the CPU to slow 
speed for a number of milliseconds each time the status register was accessed. 
With NEWDOS/80 reading the status register every 25 ms, the CPU was spending 
most of its time at the slow speed if the user was using high speed and had set 
the switch enabling low speed to be temporarily switched. Most users just let 
the computer run always at the high speed and there was no problem; however, 
the 5MHZ speed is very marginal in supporting I/O thus requiring the slowdown. 
This zap does not eliminate other status reads done by NEWDOS/80 (such as to 
keep drives rotating if they are already rotating). This zap should eliminate 
most of the CPU slowdowns that were occur ing. This zap was long delayed as it 
uses 7 of the last 10 zap bytes available in SYSO. 

SYSO/SYS, 00,33 change 

00 00 00 00 00 00 00 to F5 07 DC E8 47 Fl C9 

SYSO/ SYS ,02, E7 change 

3A EC 37 3A E0 37 01 00 FC 45 07 DC to 

3A E0 37 07 CD 53 01 00 FC 45 40 DC 



******** ZAP 061 ******** 12/28/81 ******** V2M1 ******** 

Optional zap to DOS to cause DIR to actually read ENTER and BREAK from the 
keyboard rather than just look at the keyboard matrix. This zap allows BREAK 
to work for that function only if the BREAK key is enabled. This zap allows 
remote terminal operators of NEWDOS/80 to perform the DIR function when more 
than one display page will be involved. NEWDOS/80 was not designed to be run 
from remote terminals and at many places in its code looks directly at the 
keyboard matrix rather than actually accepting an input key when looking for 
BREAK, ENTER, UP or RIGHT ARROW. This zap changes only one of these 
situations, but a number of users have said they would be happy with that. 

SYS8/SYS,02,94 change 0A 16 OF CD 6B 50 CB to 0A CD 6B 50 16 OF CB 

SYS8/ SYS ,03 , 8A change 

50 3A 40 38 E6 05 28 F9 OF D2 2D 40 3E to 

50 CD 49 00 3D CA 2D 40 FE 0C 20 F5 3E 



******** 2AP 062 ******** 01/12/82 ******** V2M1 ******** 

Mandatory zap to DOS force the 4445H call to DOS (back up one record) to set 
bit 6 of the FCB 2nd byte (disables EOF truncation)* 

SYSO/SYS, 08, 77 change 38 31 2B 18 ID CD to 38 10 2B 18 0D CD 
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******** ZAP 063 ******** 01/18/82 ******** V2M1 ******** 
Information zap. 

1. NEWDOS/80 V2 BASIC functions LOAD, RUN and MERGE implicitly require that 
the text file being read be already in ascending sorted line number order 
whereas NEWDOS/80 Version 1, NEWDOS/21, TRSDOS, VTOS, LDOS, DOSPLUS and the 
other DOS's do not. Normally, the BASIC program files are in sorted line 
number order; so this difference was not noticed for some time into Version 2'» 
release. Some users prefer to create text files in random line number order, 
relying on the implicit sort (not in NEWDOS/80 V2) done during LOAD, MERGE or 
RUN to sort the lines. These users must find some way of pre-sorting the text 
files, and since leading zeroes are suppressed from line numbers (causing line 
5000 to sort before line 51), normal sorts won't work. The following sort 
program (known as CODESORT/BAS) will perform the sort, sorting the input text 
file into a different output text file. 

10 CLEAR 2000: DEFINT A-Z: NR-0 

20 PRINT"FILESPEC OF BASIC PROGRAM TO BE SORTED?": LINEINPOT FS$ 

30 OPEN"I",l,FS$: BC!-L0C(1)% 

40 IF EOF(1)«0 THEN NR-NR+1 : LINEINPUT #1,A$: GOTO 40 

50 A$»" M : CLOSE 

60 DIM CD$(NR), IX(NR) , SN(NR) : CMD H F=SASZ",BC!-NR+200 

70 OPEN"I",l,FS$: X-l : K-l 

80 IF X>NR THEN 170 

90 LINEINPUT #1,CD$(X): Y»LEN(CD$(X)) : Z=l : W=0: SN!=0: K=K+1 

100 IFY-0 THEN 160 

110 IF Z>Y THEN 130 ELSE J=ASC(MID$(CD$(X) ,Z,1)> : Z=Z+1 : IF J-32 THEN 110 

120 IF J>»48 AND J<58 THEN W-W+l : SN!=10*SN!+J-48: GOTO 110 

130 IF W>0 AND SNK65530 THEN SN(X)-SN!-32768: X-X+l : GOTO 80 

140 PRINT K;"TH LINE HAS BAD OR MISSING LINE NUMBER. BYPASS IT? (Y/N) "; 

145 INPUT A$ 

150 IF A$«"N" THEN END ELSE IF A$<>"Y" THEN INPUT"BAD REPLY ";A$: GOTO 150 

160 NR=NR-1: GOTO 80 

170 CLOSE: IF NR-0 THEN PRINT"NO RECORDS TO SORT": END 

180 CMD"0",NR,*IXU),SN(1) 

190 PRINT"SORTED OUTPUT FILESPEC? "; : LINEINPUT FS$ 

200 0PEN"0",1,FS$ 

210 FOR X-l TO NR: PRINT #1 ,CD$(IX(X)): NEXT 

220 CLOSE: PRINT"DONE":END 



2. In BASIC, RERUM does not renumber the CMD"F", DELETE statement properly. No 
zap will be issued to correct this. 

3. The manual failed to inform programmers building programs to be executed 
that the command keyword or program name (filespec) is the first parameter of 
each DOS command and that, on entry to that program or DOS command function, 
register HL points to the parameters following the program name (filespec) in 
the DOS command statement that invoked the program. Examples: 

1. XXXXXX This DOS command causes user program XXXXXX/CMD to he 
loaded from whichever drive it is found on into memory and program 
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execution commenced at its entry location. At that time, register HL 
points to the EOL character (ODH) since there are no parameters following 
the program's filespec. Note* in absence of a name-extension for the 
filespec XXXXXX, /CMD was substituted. Also, since no drive number was 
given, the drives were searched, starting with the drive 0, looking for 
the first occurrence of XXXXXX/ CMD. 

2. YYYY/0BJ:1,5,JJJ:1 This DOS command causes user program YYYY/0BJ.1 
to be loaded into main memory from drive 1 and program execution commences 
at its entry location. At this time, register HL points the character 5 
in the above command, as this is the first character of the first 
parameter following the program filespec. The user program may 
interrogate the parameter(s) with the EOL character (ODH) indicating the 
end of parameters. 

3. ZZZ,Y,N,MYFILE This DOS command causes user program ZZZ/CMD to be 
loaded into main memory and execution started at its entry location with 
HL pointing to the character Y 

3. A number of users have asked why HEWDOS/80 Version 2 lacks features that 
other DOS's have. For the most part and for obscure reasons, we just elected 
to exclude them, but in many cases the main problem is that sufficient resident 
main memory space or overlay main memory space or both is not available. 

1. In the DOS main memory region, 4000H thru 51FFH, NEWDOS/80 has 256 
bytes less resident (always in memory) code/data than other DOS's have as 
it uses this 256 bytes to make the DOS overlay programs (i.e., SYS1/SYS) 
bigger. 

2. Some DOS's have taken part of their resident code/data into high 
memory in order to gain more resident memory for DOS. For HEWDOS/80 
Version 2, it was decided to remain out of high main memory, with the 
exception of the spooler, which was already there. 

3. NEWDOS/80 has MINI-DOS which most other DOS's do not. This means that 
most of the DOS commands (DIR, FREE, LOAD, etc.) that execute in the 5200H 
thru 6FFFH region of main memory (and may call overlay routines that 
execute in the 4E00H thru 51FFH region) in other DOS's must execute in 
HEWDOS/80 entirely within the 4D00-51FFH DOS overlay region. This 
complicates the effort to extend the capabilities of any given DOS 
command. 

4. A number of users have asked why SETCOM and FORMS were not included in 
Version 2 for the Model I like they were for the Model III. The author's 
excuses, weak as they are, are as follows: 

1. For FORMS, of the two parameters, only LINES could have been 
accommodated as that is all the Model I ROM printer routine (used by 
NEWDOS/80) allows for* Host users that had to change the lines-per-page 
value at 4018H (16424 decimal) were already doing so, either via the POKE 
function of BASIC or the M function of DEBUG. 

2. For SETCOM, this command changes the parameters in 3 control blocks 
for the RS-232C interface. NEWDOS/80 VI and V2 for the Model I have no 
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main memory allocated for these three control blocks, and the Model 1 ROM 
does not have some of the routines used to change these control blocks, 
whereas the Model III does. Lastly, many excellent widely used RS-232C 
programs were already in existence handling the interface quite well 
without FEWDOS/80. 

5. A number of users have asked why DIRECTORY READ ERROR or DIRECTORY "WRITE 
ERROR appear as the DOS error message when an error occurs with a directory 
sector. Why not display the regular error code? We did this in order that 
normal file processing, the user would know that the directory, rather than 
his/her file, was the source of the error. At the time the error code 
substitution takes place, the system does not know whether or not the directory 
I/O was subsidiary to file I/O. We do apologize for the confusion created when 
the directory I/O was the main I/O (i.e., in DIR, FREE, etc.). The UBer can go 
to SUPERZAP and step through the directory (via DD, DTS or DFS (on DIR/ SYS) to 
determine which sector is had and what is the actual complaint. VDS mode can 
also be used. 

6. LNW-80 users should be aware that that computer does not use the Z-80 
instruction HALT to trigger the computers RESET line as does the TRS-80 Model 
I. Therefore, the BOOT DOS command and any other program that uses the Z-80 
HALT instruction to RESET the computer will simply stop execution, which is 
what the normal Z-80 HALT instruction does. The user will have to actually 
press the RESET keys. 



******** zap 064 ******** 02/15/82 ******** V2M1 ******** 

Mandatory zap to DOS to cause the /./5Y function of chaining (see page 4-11) to 
properly exit the current DOS-CALL level, if any, under certain circumstances 
where it was not. This problem can also be avoided by using CHH0K,Y instead of 
/./5Y if DOS is awaiting its next command at that DOS level. 

SYS9/SYS.01.97 change 43 B7 20 06 CB to 43 CD 3A 51 CB 

SYS9/SYS,04,4E change 

00 00 00 00 00 00 00 00 00 00 00 00 00 to 

B7 C2 99 4E 78 E6 50 FE 40 CA 2D 40 C9 

******** zap 065 ******** 02/15/82 ******** V2M1 ******** 

information zap. 

1. When COPY format 6 (CBF) is used to copy a system diskette and the system 
files are to be copied, the FMT parameter MUST be specified! II! On page 2-14, 

last paragraph, is stated "If NFMT is specified system files are not 

copied unless already existent in the destination file directory.". This is 
not true; if HFMT is specified or implied, the files are copied, but (1) 
SYS0/SYS will usually be in the wrong position causing BOOT to fail and (2) 
other syBtem files may be in the wrong directory slots, eventually causing even 
worse trouble. 
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2. Some Users have had GAT OVERFLOW error occur when using CBF with FMT to 
copy a system diskette. The system files SYS1/SYS through SYS21/SYS on a 
system diskette are positioned near the directory, some file above and some 
below, to enhance system efficiency. During the CBF COPY, the each system file 
is assigned space on the destination diskette in the same position relative to 
the direct6ry as on the source diskette, and if that position is beyond either 
end of the diskette, GAT OVERFLOW error occurs. The solution to the problem is 
to cause the directory to be positioned nearer the center of the diskette. Two 
of the destination diskette's PDRIVE parameters are involved in the directory 
positioning: GPL and DDSL. Compute the number of lumps on the diskette and 
compare against DDSL to determine which end of the diskette the directory is 
too close to. You can take one of three actions to cause the directory to move 
closer to the diskette center: (1) change the DDSL value, (2) decrease the GPL 
value if the directory was too near the end of the diskette, or (3) increase 
the GPL value if the directory was too near track 0. 

3. A number of users have complained that the LIST and PRIKT commands do not 
allow for graphic characters. This was done so purposely as the intent with 
both LIST and PRINT was to provide a rudimentary, emergency method of listing 
or printing regular text files (files whose printable characters are between 
20H and 7FH ASCII or that modulate to those values). These two commands were 
seldom used in NEWD0S+ or NEWDOS/80 Version 1, and we have been surprised by 
the increased useage in Version 2. For a subsequent release of NEWD0S80, we 
will try to add more capabilities to allow for graphics, but for now we simply 
apologize that the capability is not there. 

4. For Model I users having CPU speed up modification installed that find that 
NEWDOS/80 Version 2 fails in double density I/O (or single density 8") where 
NEWDOS/80 Version 1 (using someone else's double density patches) worked, the 
user should ask the purveyor whether the speed up modification, when set to 
normal speed, actually causes the CPU to run slower than the standard Model I 
speed of 1.772 MHZ. Some of the earlier speed up mods did, and NEWDOS/80 
Version 2 cannot tolerate any slowdown below 1.772 MHZ. 

******** ZAP 066 ******** 03/16/82 ******** V2M1 ******** 

Mandatory 2ap to BASIC to correct error in dynamic MERGE occuring when the old 
text has lines within the range of the merging text (though not matching line 
numbers, which is not allowed). This is an unusual condition but nevertheless 
legal. This error was causing string variables whose strings are in the text 
area to not be properly repointed into the resulting text. 

SYS19/SYS,00,DA change C5 21 3E 54 22 to C5 CD 20 56 22 

SYS19/SYS,02,9D change CI Dl El C9 2A to CI C3 2A 56 2A 

SYS19/SYS,02,E2 change CD F2 54 CD to CD 38 56 CD 

SYS19/SYS, 03,76 change 

00 ED 52 38 2E 21 00 00 ED 52 30 27 AF to 
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00 00 CD 41 56 21 00 00 09 CD 49 56 AF 

SYS19/SYS ,04,34 change 

0000 0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 0000 0000 0000 
0000 0000 0000 0000 0000 0000 0000 0000 
0000 0000 00 

to 

2100 0022 4256 213E 54C9 2A42 

56ED 5B7A 5519 2242 56D1 E1C9 474F ED43 

4256 C3F2 5401 0000 09ED 5218 03ED 523F 
D0F1 C399 55 

******** ZAP 067 ******** 03/25/82 ******** V2M1 ******** 

Mandatory zap to allow the TRSDOS 1.2 Model III VISICALC Version VC-150Y0-T83 
to operate with Model I NEWDOS/80 Version 2. The 1st zap disables VISICALC's 
directory search feature. The 2nd and 3rd zaps insert the Model I HIMEM value. 
The 4th and 5th zaps disable the disabling of the Model III abort- on-BREAK 
RS-232 function which is not available on the Model I. The 6th zap performs a 
Model I check for the BREAK key. The 7th, 8th and 9th zaps disable VISICALC' s 
direct printer interface (command /PR) with the RS-232 serial port which is not 
available on the Model I (the user may still use his/her own driver that takes 
/PP parallel printer output to the RS-232). 

The directory search capability of VISICALC is disabled as NEWDOS/80 does not 
have the RAMDIR facility that Model III TRSDOS does. However, it is possible 
to use MINI-DOS to search the directory by (1) typing in the /SL command, (2) 
pressing DFG to enter MINI-DOS, (3) perform the MINI-DOS functions, (4) clear 
the display, (5) exit from MINI-DOS, (6) back in VISICALC, press three or more 
CLEARs to clear the command state, (7) execution one of the /T commands to 
restore the VISICALC display. 

VC/CMD,86,CA change E5 CD 90 42 FD to E5 3E 08 B7 FD 

VC/CMD,00,1E change 2A 11 44 7D to 2A 49 40 7D 

VC/CMD,00,AA change 2A 11 44 11 to 2A 49 40 11 

VC/CMD,84,CB change C9 32 03 42 CD to C9 00 00 00 CD 

VC/CMD,85,25 change C9 32 03 42 CD to C9 00 00 00 CD 

VC/CMD,83,9D change 

F5 C5 D5 E5 CD 8D 02 28 0A CD 2D A4 El Dl CI Fl to 

F5 3A 40 38 E6 04 CC 35 A4 C4 2D A4 28 0B 00 Fl 

VC/CMD,84,C2 change E5 CD 5A 00 to E5 00 00 00 

VC/CMD,85,05 change E5 CD 55 00 to E5 00 00 00 

VC/CMD,84,BB change FF 32 FA 41 DD to FF 00 00 00 DD 
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******** ZAP 068 ******** 04/13/82 ******** V2M1 ******** 

Mandatory zap to DOS to correct an error in CREATE whereby the old file's (not 
the new) EOF was not being set = when REC-0 parameter spec'ed or defaulted 
to. 

SYS14/SYS,02,FE change 28 47 to 28 41 



******** 2AP 069 ******** 04/13/82 ******** V2M1 ******** 

Mandatory zap to DOS to correct error in the DMDB function of SUPERZAP where 
the F, function was not displaying the correct dump location. 

SUPERZAP/CMD.05,12 change 03 2A B2 54 CD to 03 CD 14 52 CD 

SUPERZAP/CMD, 00,18 change 00 00 00 00 00 00 to 3A B3 54 67 18 F6 



******** 2AP 070 ******** 04/23/82 ******** V2M1 ******** 

Mandatory zap to BASIC to correct an error in CMD"0" sort of floating point 
values and, to a much lesser degreee, of character strings. It is astonishing 
that this error was finally reported 8 months after Version 2 release; we 
simply refused to believe it as this meant virtually no one is using the 
floating point sort feature. The reporting user was persistent, however, 
sending in a very detailed problem report even so far as providing the zap! 
Well done!.!! We thank this user and all others that persist in proving their 
point. 

SYS21/SYS,03,1E change 18 29 B7 to 18 2B B7 



******** 2AP 071 ******** 05/04/82 ******** V2M1 ******** 

Mandatory zap to VISICALC Version VC-160Y0-T83 for Model III TRSDOS 1.3 to 
operate with Model I HEWDOS/80 Version 2. Refer to ZAP 067 as this zap 
performs the same functions as that zap did for the TRSDOS 1.2 version. 

VC/CMD,86,EB change E5 CD 90 42 FD to E5 3E 08 B7 FD 

VC/CMD,00,1E change 2A 11 44 7D to 2A 49 40 7D 

VC/CMD,00,B5 change 2A 11 44 11 to 2A 49 40 11 

VC/CMD,84,EF change C9 32 03 42 CD to C9 00 00 00 CD 

VC/CMD,85,46 change C9 32 03 42 CD to C9 00 00 00 CD 
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VC/CMD,83,BB change 

F5 C5 D5 E5 CD 8D 02 28 OA CD 4B A4 El Dl CI Fl to 

F5 3A 40 38 E6 04 CC 53 A4 C4 4B A4 28 OB 00 Fl 

VC/CMD,84,E6 change E5 CD 5A 00 to E5 00 00 00 

VC/CMD,85,26 change E5 CD 55 00 to E5 00 00 00 

VC/CMD,84,DF change FF 32 FA 41 DD to FF 00 00 00 DD 

******** 2AP 072 ******** 05/04/82 ******** V2M1 ******** 
Information zap on Model III TRSDOS diskettes. 

Despite explicit and implicit statements in the manual and the zaps, users 
continue to think that Model III TRSDOS type diskettes are directly useable 
with NEWDOS/80 Version 2. NEWDOS/80 Version 2, with two exceptions, CANNOT, 
repeat, CANNOT operate with TRSDOS Model III system or data diskettes. Please 
believe us; this is sol! I! DO NOT ATTEMPT to use Model III type diskettes 
(data or system) with NEWDOS/80 except for the special conditions of COPY and 
SUPERZAP wherein PDRIVE TI flag M is used!!!!! I If you must use the DIR 
command to determine what is on a Model III TRSDOS type diskette, do so under 
TRSDOS, not NEWDOS. 

The directory for Model III TRSDOS system and data diskettes is markedly 
different from the directory used on Model I TRSDOS 2.3 and all NEWDOS 
diskettes. For NEWDOS/80 Version 2 on the Model III, Apparat elected to remain 
with the old style directory so that data diskettes (once the address mark had 
been adjusted; see WRDIRP command and SYSTEM option BN) could be used 
interchangeably between the Model I and Model III under NEWDOS/80 Version 2 on 
both computers. 

Realizing that data files and some program files must be transferable between 
TRSDOS Model III type diskettes and NEWDOS/80 Version 2 type diskettes, 
NEHDOS/80's COPY command, formats 1-4 and 6, allow, via special PDRIVE 
conditions, files to be copied from a Model III TRSDOS type diskette to a 
NEWDOS/80 Version 2 type diskette and from a NEWDOS/80 Version 2 type diskette 
to a Model III TRSDOS type diskette (note, COPY formats 1 and 2 filespecs for 
Model III TRSDOS files must have an explicit drive number). The special PDRIVE 
state is given in PDRIVE, example 3, page 2-38, and provides only for Model III 
TRSDOS type diskettes that are single sided, double density, 40 track. On your 
master Model III NEWDOS/80 system diskette, PDRIVE display slot # 4 was 
initialized to the correct value to use with these Model III TRSDOS 1.3 type 
diskettes {see zap 013 for TRSDOS 1.2 or 1.1 diskettes; see zap 031 for Model I 
TRSDOS 2.3B diskettes). For the remainder of this discussion, we will assume 
PDRIVE specification 4 contains the following values; 

TI-xM,TD=E,TC=40,SPT«18,TSR-3,GPL=6,DDSL=17,DDGA=2 
where x is C for PERC0M type double density interface and E for LNW 
type interface. 
There are many variations available for copying to/from Model III TRSDOS 
diskettes which the more experienced NEWDOS user will adapt for his/her own 
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usee. The following examples are to get the novice through the first anxious 
moments. In each example, drive is assumed a double density drive. 

1. To copy file XXX/DAT from a Model III TRSDOS type diskette to a 
preformated REWDOS/80 Version 1 diskette, the following command will work: 

COPY, XXX/DAT:0, XXX/DAT: 1,SPDN=4 
NEWDOS/80 will ask for the mount of the source diskette (the Model III 
TRSDOS type diskette) and the system diskette (the HEWDOS/80 Bystem 
diskette) on drive as necessary. 

2. To copy multiple files from a Model III TRSDOS type diskette to a 
previously formatted HEWDOS/80 type diskette, the following command will 
work: 

COPY ,0,1,, NFMT , CBF , CFWO , SPDN=4 
NEWDOS/80 will ask for the mount of the source diskette (the Model III 
TRSDOS type diskette) and the system diskette (the NEWDOS/80 system 
diskette) on drive as necessary. The user will be asked, one file at a 
time, which files are to be copied, except that files marked as system 
files are excluded automatically from the copy. To copy a Bystem file, 
use the single file copy example above. 

3. To copy file XXX/DAT from a NEWDOS/80 Version 2 diskette to Model III 
TRSDOS diskette, the following command will work: 

COPY , XXX/DAT : 1 , XXX/DAT: ,DPDN«4 
NEWDOS/80 will ask for the mount of the destination diskette (the Model 
III TRSDOS type diskette) and the system diskette (the NEWDOS/80 system 
diskette) on drive as necessary. 

4. To copy multiple files from a NEWDOS/80 type diskette to a previously 
formatted (under TRSDOS) Model III TRSDOS type diskette, the following 
command will work: 

COPY, 1 ,0 , ,NFMT ,CBE,CFW0,DPDN=4 
NEWDOS/80 will ask for the mount of the destination diskette (the Model 
III TRSDOS type diskette) and the system diskette (the NEWDOS/80 system 
diskette) on drive as necessary. The operator will be asked, one file 
at a time, to select which files are to be copied, excepting that any 
files marked as system files are automatically excluded from the copy. To 
copy a system file, use the single file copy example given above. 

NEWDOS/80 Version 2 does not provide a. method of copying to/from DOS's other 
than itself and TRSDOS. It is our intention that the TRSDOS diskette remain 
the common media for moving data between non- TRSDOS DOS's which is why we took 
the extra trouble to be able to copy TO a Model III TRSDOS diskette. 

For the experienced user, SUPERZAP modes DD and DTS can be used to inspect 
Model III TRSDOS type diskettes provided the PDRIVE specifications are set 
correctly. The command 

PDRIVE, 0,1=*4, A 
will activate the drive #4 specifications as drive #l's specifications, thus 
allowing SUPERZAP to inspect a Model III TRSDOS type diskette on drive 1. When 
done, don't forget to Change the PDRIVE specifications for drive 1 back. The 
Model III TRSDOS directory is 18 sectors long, starting at relative sector 306; 
remember, the directory format is different than that for NEWDOS/80. 
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******** 2AP 073 ******** 05/04/82 ******** V2H1 ******** 

Information zap on Model I TRSDOS 2.3B and higher diskettes. Refer also to ZAP 
031. 

Some time ago Radio Shack announced a double density modification to the Model 
I TRSDOS. To date, this modification is not available and Apparat does not 
know what zaps will have to be issued to operate with the new Model I TRSDOS 
2.3B or higher double density diskettes. We assume that the new Model I TRSDOS 
will continue with the implementation of RBA format in the FCBs and the 
directories (which make the new TRSDOS diskettes incompatible with the old 
TRSDOS and with HEWDOS diskettes), and that like Model III TRSDOS diskettes, 
the new Model I TRSDOS diskettes will useable with NEWDOS/80 Version 2 only 
with COPY and SUPERZAP (see above zap) when the PDRIVE setting includes TI flag 
M. However, for now, use of flag M does not allow access to Model I TRSDOS 
double density diskettes as a TD code for double density implies Model III. 



******** ZAP 074 ******** 05/12/82 ******** V2M1 ******** 

Mandatory zap to CHAIBBLD/BAS to eliminate an unintended and non-displayed 
CLEAR character that causes trouble during PRINT of an ASCII copy of the 
program. This character is non-displayed but is the character in text 
immediately following the G0S0B36 of line 92. Load the program under BASIC, 
delete the character, and SAVE the CHAINBLD/BAS file back. Line 92 should 
display exactly the same after the character delete as before. 



******** ZAP 075 ******** 05/12/82 ******** V2M1 ******** 

Mandatory zap to BASIC to correct memory-wipe-out error caused in certain 
circumstances by a REF= statement containing a ' character. The actual error 
is at 1A8B - 90 in the ROM and can be triggered in non-disk BASIC by keying in 
twice the direct command sss' where sss is three spaces. By making a change to 
NEtfDOS/80's BASIC, the problem with REF is avoided. 

SYS18/SYS,02,1A change 

36 20 23 DF 38 FA 2B 36 FF 18 39 EB to 

36 FF 23 DF 30 3E 36 20 23 18 F8 EB 



******** zap 076 ******** 06/18/82 ******** V2M1 ******** 

Mandatory zap to DOS to allow NEWD0S/80 to run with the Radio Shack double 
density modification. This zap does NOT enable NEWDOS/80 to operate with Model 
I TRSDOS 2.7DD double density diskettes (see ZAP 078). PDRIVE TI flag D is 
hereby activated (please note this in the margin on page 2-34) for the Model I 
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to mean the Radio Shack double density interface, and all PDRIVE specifications 
for this interface must use TI flag A or D for single density diskettes and TI 
flag D for double density diskettes. If drive is to be double density, TI=DK 
must be specified (with TC reduced by 1 (i.e., 34, 40, 76 or 79)). The Percom, 
LNW and Omikron double density interfaces for the Model I do not use write 
pre compensation as does the Radio Shack interface. Since there is not enough 
resident DOS patch area to patch in precompensation and still retain system 
diskette inter changeability with other interfaces} it has been left out of this 
mandatory zap, but has been included as optional zap 077 below wherein the 
zapped NEWDOS/80 system diskette must only be run with an unmodified interface 
or with the Radio Shack DD interface. 

******** Creating a system diskette to operate with a different I/O interface 
(i.e., the R. S. doubler) requires that the system diskette be created by 
format 5 or 6 COPY with FMT parameter specified. 

******** xi flag D is interdrive mutually exclusive with flags B, C and E 
meaning that if D is specified in any drive's specification, then no other 
drive's specification may contain TI flags B, C or E. "TI= SPEC BETWEEN DRIVES 
INCOMPATIBLE" error will be given if this interdrive mutual exclusion is 
violated, requesting that you alter the various PDRIVE specs until atmost one 
of TI flags B, C, D or E is represented in the various PDRIVE specifications. 

********* NEVER, NEVER, NEVER reset or boot the computer with PDRIVE showing an 
error. If this is done, the initialization routines will simply refuse to 
boot. 

SYS6/SYS,07,7D change 

ED 5BC1 
59CD 8457 ED4B 9459 CB49 2047 CDF9 56CB 
6828 062A 8159 22CE 42 
to 

DD 5604 
DD4E 06DD 7E02 E61C FE08 C079 EE20 DD77 
06C9 DD71 06DD 7307 C9 

SYS6/SYS,27,C1 change 07 DD 56 04 DD to 07 CD D7 54 DD 

SYS6/SYS,27,CD change 

01 CD 59 69 20 03 CD AA 67 Dl DD E3 F5 DD 73 07 DD to 

01 C5 CD 59 69 CC AA 67 CI Dl DD E3 F5 CD EC 54 DD 

SYS16/SYS,00,D6 change 05 7B 07 F6 FC 57 DD to 05 16 80 CD 95 51 DD 

SYS16/SYS,02,56 change E6 68 CO to E6 60 CO 

SYS16/SYS,02,6A change 20 ID CB to 20 10 CB 

SYS16/SYS,04,A9 change 00 00 00 00 00 00 to CB 43 CO 16 AO C9 
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******** ZAP 077 ******** 06/18/82 ******** V2M1 

Optional zap to DOS to enable the Radio Shack double density write 
pre compensation logic. When this zap is applied, the system diskette must only 
be used with either an expansion interface that has not been modified for disk 
double density or 8 inch drives or has been modified for the Radio Shack double 
density disk I/O. Once the diskette is modified, indicate on its label that 
this zap is installed. 

SYS0/SYS,01,40 change 

EF 00 00 00 3E 2A 18 AE C3 to EF 32 EE 37 C3 67 47 00 C3 

SYS0/SYS,01,62 change 

EF 00 00 00 00 00 00 18 D9 AF to EF 3E CO 30 DA 3E EO 18 D6 AF 

SYS0/SYS,03,9A change CD 67 47 to CD B3 47 

SYS0/SYS,04,A9 change 

5E F3 3A 11 43 F6 FE 77 36 DO FB 23 to 

5E 18 08 3A 0D 43 OF BA C3 76 44 23 

SYS6/SYS,29,5F change CD 67 47 to CD B3 47 



******** 2AP 078 ******** 06/18/82 ******** V2K1 ******** 

Optional zap to allow COPY formats 1, 2, 3, 4 and 6 to copy files from or to 
Model I TRSDOS 2.7DD double density diskettes when the PDRIVE for that diskette 
is: 

TI=xM , TD»E , TC- t c , SPT-1 8 , TS R=3 , GPL=6 , DDS L»dt , DDGA-2 
where: 

x = C for Fercom type double density modification, D for Radio Shack type 

modification and E for LNW type modification. 

tc ■ diskette track count, 35 t 40 or whatever. This track count includes 

the single density track 0. 

dt - the directory track number (the standard is 17). NEWD0S/80 must be 

given the correct value as it does not obtain the value from the 

diskette's boot sector in the single density track 0. 
See example 3, page 2-38. If ZAP 013 is applied to the diskette receiving this 
zap, ZAP 013 must be taken out before this zap is applied. Once this zap has 
been applied, the zapped diskette cannot be used to copy to/ from Model III 
TRSDOS diskettes or to/ from Model I TRSDOS 2.3B diskettes; this zap should only 
be applied to a special KEWDOS/80 system diskette whose sole function is to be 
used when copying files to/from Model I TRSDOS 2.7DD double density diskettes. 

A Model I TRSDOS 2.7DD double density diskette cannot be formatted by 
NEWDOS/80, and it cannot he format 5 copied by HEWDOS/80, not even via the BDU 
option. Further, remember, format 6 (CBF) COPY does not copy system fileB 
to/from TRSDOS diskettes; formats I through 4 do, however. 

Users must be aware that Model I TRSDOS 2.7DD double density diskettes are 
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written with track in single density and all other tracks in double density; 
the directory information assumes track is in double density and counts its 
information from track O's 1st sector. Note, that track is allocated on all 
diskettes to BOOT, a file that contains 10 sectors, not 18. 

SYS6/SYS,14,25 change 

00 3D 46 01 A8 41 46 01 A9 37 47 03 G3 0B 5C 37 48 01 OD 77 48 03 C3 to 

00 A5 48 01 3E EE 48 01 00 F3 48 07 ED 5B 99 43 CD OB 5C 8A 5B 00 C3 

SYS6/SYS,14,67 change 01 50 DO to 01 80 DO 

SYS6/SYS, 14,76 change 00 7B 4F 01 1A AF to 00 38 50 01 C9 AF 

SYS6/SYS,14,82 change 

00 61 50 03 3E 1A B7 D6 to 00 67 50 03 36 80 23 D6 

SYS6/SYS,14,8E change 

5C 12 51 01 1A 55 51 04 21 EF 5C C9 to 5C 0E 51 01 00 55 51 04 21 CD 40 C9 

SYS6/SYS,14,A2 change 00 61 4E 01 0D 6C to 00 8F 4E 01 80 6C 

SYS6/SYS,14,B1 change 

5B 18 EF 4E 02 35 56 DA 4E 01 2F 8B 4E 01 18 72 to 

5B 28 EF 4E 02 35 56 E9 4F 02 36 00 00 5C 00 72 

SYS6/SYS.14.D0 change 

00 FB CI 20 0A 3A C4 46 E6 to 00 21 08 00 19 7E 12 C9 E6 

SYS6/SYS,14,E9 change 3E 05 CD to 3E 08 CD 

SYS6/SYS,14,FB change 3E 30 CD to 3E 20 CD 

SYS6/SYS,15,21 change 06 50 7E to 06 80 7E 

SYS6/SYS,20,11 change 01 EF 5C 23 to 01 CD 40 23 

SYS6/SYS,20,97 change 3E 50 20 to 3E 80 20 

******** 2AP 079 ******** 06/27/82 ******** V2M1 ******** 

Mandatory zap to DOS to correct error occurring when a file with EOF = is 
copied (via single file COPY) to a NEWDOS/80 diskette from TRSDOS diskette 
other than the old TRSDOS 2.3 (or as now being called TRSDOS 2.3A) diskettes. 

SYS6/ SYS , 5 , C5 change 

52 3A 14 53 B7 C8 CD 35 55 2A to 52 CD 35 55 3A 14 53 B7 C8 2A 
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******** zap 080 ******** 07/19/82 ******** V2M1 ******** 

Mandatory zap to NEWDOS/80's ASP0OL program to correct error in the *ASP,S 
function where the computer is forced to DOS READY after the remaining spooled 
print completes printing. Instead, the delayed completion of the function 
should simply continue the interrupted program. To make room for this 
correction, the SPOOL PURGED message is no longer displayed. To determine that 
the spooler is gone, simply execute the MSP command asking for spooler status. 
If the response is FILE NOT IN DIRECTORY, the spooler is gone. 

ASPOOL/MAS,02,E8 change 

44 C2 09 44 21 8B 58 CD 67 44 C3 2D 40 01 to 

44 CI 21 08 44 B7 ED 42 C8 C3 15 55 00 01 



ZAP 081 ******** 08/17/82 ******** V2M1 ******** 

Mandatory zap to LMOFFSET to correct error where the first program is stored 
with a disable-DOS appendage and the second program is stored with an appendage 
that does not disable DOS. This error causes the 2nd stored program to have a 
bad appendage. 

LMOFFSET/ CMD, 00 ,34 change 53 21 3E 5 A CD to 53 CD 15 5D CD 

LMOFFSET/ CMD, 09 ,8F change 

00 00 00 00 00 00 00 00 00 to 3E 50 32 C3 58 21 3E 5A C9 



******** ZAP 082 ******** 08/31/82 ******** V2M1 ******** 

Information zap to allow BASIC and assembler programs to set the lower case 
state with the Model I NEWDOS/80 Version 2 DOS resident code. To execute the 
equivalent of the DOS command LC,N without causing disk I/O, BASIC programs 
execute POKE 17844,0 and assembler programs store 00 into 45B4H. To execute 
the equivalent of DOS command LC,Y withou causing disk I/O, BASIC programs do 
POKE 17844,201 and assembler language programs store 0C9H into 45B4H. 
Remember, the lower case driver (see DOS command LCDVR) must be active for 
these POKEs to work. 

********* WARNING!!!!! This 17844 (45B4H) location is NEWDOS/80 Version 2 
dependent and definitely will be different in any subsequent NEWDOS/80 release. 

Users should mark this carefully in their programs. This is why we were so 
reluctant to release this information. 



******** ZAP 083 ******** 09/02/82 ******** V2M1 ******** 

Mandatory zap to Radio Shack's Model I SuperSCRIPSIT for TRSDOS 2.3 (not 2.3B 
or 2.7DD) to enable it to run with the Model I NEWDOS/80 Version 2: 
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1. Allow the Main Menu Directory function to work. An actual NEWDOS/80 
directory is executed via DOS-CALL; so the display will look different 
from that for TRSDOS. NOTE, the main menu display for the Model I does 
not show the "<D> Display diBk directory" option as it does for the Model 
111, but a response of D will trigger it. 

2. Allow the program to determine the number of 1024 byte page units of 
diskette space are available on the target drive. To do this, the DOS 
command DIR x,/Q9Q (where x is the drive #) is executed via DOS- CALL as 
NEWDOS/80 does not have the RAMDIR function. This causes an extra 
directory display to appear for during Main Memory function that opens a 
document (appears after you have adjusted the document control data). 
This extra directory display may also appear at other times. 

This zapped SuperSCRIPSIT must only be used with NEWDOS/80 Version 2 for the 
Model I. 

With SuperSCRIPSIT, users may use DOS functions DFG (MINI-DOS) and 123 (DEBUG), 
but they must be very careful when pressing the three keys as SuperSCRIPSIT is 
likely to receive one or more of them. When a page of text is displayed, using 
the control-H command (HELP) puts the users where DFG or 123 may be pressed. 
Upon executing DOS command MDRET (to exit Mini- DOS back to Super SCRIPT) or 
DEBUG command G (to exit DEBUG back to SuperSCRIPT) , press BREAK to return to 
the page. If HELP was not available, you will additionally have to press 
control-T followed by BREAK to get back the full display. From the main menu, 
use option D to display a directory; then while the program is awaiting BREAK, 
you can press DFG or 123. WARNING!!!! Do not exit directly to DOS from 
Mini-DOS or DEBUG without giving SuperSCRIPSIT its chance to write data from 
memory and close its files; this can be disastorous to your document file. 

SCRIPSIT/CMD,09,06 change 

AB4F CDFO 4AC0 2100 4D01 
2300 CBlE 3801 04CB 1E38 0104 0D23 20F2 
0405 2801 0102 005B 0521 0500 CD71 6606 
04CD 5166 7D32 227E AFC9 0000 0000 0000 
0000 0000 0000 0000 0000 0000 0000 0000 
0000 

to 

ABC6 3032 225B 211E 5BCD 
1944 C006 0411 333C 21DC AC1A 7713 D630 
FE0A 3001 0102 005B 2310 F436 84CD B268 
0605 CD71 6606 04CD 5166 7D24 2528 023E 
FF32 227E AFC9 4449 5220 302C 2F51 3951 
0D00 

SCR17/CTL,02,3A change 

69 FE 30 38 F9 FE 34 30 F5 CD E5 75 0E 00 32 71 42 CD 19 44 3E OF CD 33 00 21 

69 32 70 8D 21 6C 8D CD 19 44 28 05 F6 CO CD 09 44 18 06 44 49 52 20 30 0D 21 

SCR17/CTL,04,AF change 8E 00 4E to 8E 44 4E 
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******** ZAP 084 ******** 09/17/82 ******** V2M1 
Information zap. 

1. Most users are still puzzled about using multi-dimension arrays with 
BASIC'S CMD"0". Please refer to section 7.21 in the manual and ZAP 41.4. 
CMD"0" was intended for single dimension arrayB only, but it was found that a 
multi-dimension array could also be sorted if the user understands that the 
arrays items sorted (directly or indirectly) actually occupy consecutive memory 
locations (as assigned by BASIC during execution of the associated DIM 
statement) starting with the element specified in the CMD "0" statement * For 
single dimension arrays, this is the same order as ascending order of 
subscript, but for multi-dimension arrays, the order of elements used in the 
sort is COMPLEX and is given by the REN formulas. If you are going to sort a 
multi-dimension array, it is highly recommend that the sort start with the 
array's first element (i.e., the array's item specified in the CMD"0" statement 
should have all zero subscripts (i.e., A(0,0,0) for a 3 dimension array)). 
If you use anything other than zero subscripts for the sort Of a 
multi-dimension array, you must be very clever to figure Out which elements 
actually participate in the sort. 

The REN formulas given on pages 7-14 and 7-15 show how to compute the REN for a 
given element in the array. Following are the formulas for computing the 
element subscripts corresponding to a given REN value (remember, the first REN 
value is zero). 

1. For a single dimension array whose DIM statement is DIM A(R1) and 
for array element A(X1); 

XI » REN 



2. For a two dimension array whose DIM statement is DIM A(R1,R2) and 
for array element A(X1,X2): 

REN/(R1+1) gives a quotient that is X2 and a remainder that is XI. 

3. For a three dimension array whose DIM statement is DIM A(R1,R2,R3) 
and for array element A(X1,X2,X3): 

REN/((R1+1)*(R2+1)) gives a quotient that is X3 and remainder M2 
such that M2/(R1+1) gives a quotient that is X2 and a remainder 
that is XI. 

For an n dimension array (where n is not 1) the calculation involves REN 
being divided by product of all the ranges (a range is 1 greater than the 
value given in the DIM statement) except the nth, giving a quotient that 
is the nth subscript and a remainder that can be used as the REN value for 
calculating n-lth subscript as if the array had only n-1 dimensions. 
Continue this loop until n is reduced to 1 . 



13-43 



2. Manual correction for ATTRIB, section 2-3, page 2-4. Place a note there to 
indicate that parameter LRL=lenl existB, allowing the user to alter the 
Logical Record Length of the file to the value lenl ( 1 to 256 ). This value, 
kept in the file's FPDE in the directory, is hardly ever used except by DIR, 
but some people want DIR to show the correct value. Remember, in NEWDOS/80 
OPENs of a file, the LRL value is taken from register B rather than from the 
directory (in BASIC, it comeB explicitly or implicitly from the OPEN 
statement) . 



******** ZAP 085 ******** 11/29/82 ******** V2M1 ******** 

Mandatory zap to DOS to correct error that was allowing a format 5 COPY to 
occur when both diskettes had the same number of sectors but different GPL 
values. 

SYS6/SYS,22,36 change 5A 28 OE CB to 5A 00 00 CB 



******** ZAP 086 ******** 12/17/82 ******** V2M1 ******** 

Mandatory zap to EDTASM to correct error where an error flag was not being 
reset after failure of a file open, thus causing the next file operation to 
fail to CLOSE a file properly. 

EDTASM/CMD,30,61 change CA F8 01 CD to CA 08 57 CD 

EDTASM/CMD,03,23 change C9 3A 28 52 F6 08 32 to AF 32 2E 76 C3 F8 01 



******** zap 087 ******** 12/21/82 ******** V2M1 ******** 

Mandatory zap to BASIC to correct error in CMD"0" direct sort where an array is 
specified twice in the command sequence (i.e., two parts of a string supply 
independent sorting criteria. 

SYS21/SYS,01,14 change 04 DD 77 04 D7 to 04 CD E0 65 D7 

SYS21/SYS,01,7F change DF C2 4A IE Fl to DE CD E5 65 Fl 

SYS21/SYS,01,8E change 01 32 02 4F Fl to 01 CD 17 66 Fl 

SYS2l/SYS,02,88 change DD 7E 04 B7 28 to DD CB 04 7E 28 

SYS21/SYS,03,EE change C9 DD 5E 13 DD to C9 CD 20 66 DD 

SYS21/SYS,04,2C change 14 19 10 FD C9 to 14 C3 2B 66 C9 
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SYS21/SYS,04,B5 change 

OC 28 05 2B IB ED B8 13 DD 73 09 DD 72 OA DD to 

OC EB B7 ED 42 DD 75 09 CD 34 66 20 22 00 DD 

BASIC/CMD > 14,E9 change 

00 0000 0000 0000 
0000 0000 0000 0000 0000 0000 0000 0000 
to 

DD CB04 FEC9 C24A 
1E3A 0251 B7FD 2100 4228 04FD 2117 42E5 

BASIC/CMD.15,00 change 

0000 0000 0000 0000 0000 0000 0000 0000 

0000 0000 0000 0000 0000 0000 0000 0000 

0000 0000 0000 0000 0000 0000 0000 0000 

0000 0000 0000 0000 0000 0000 0000 0000 

0000 0000 0000 0000 0000 0000 0000 0000 

00 

to 
DD6E 05DD 6606 FD5E 05FD 5606 DF20 04DD 
CB04 F611 1700 FD19 FD7E 0OB9 38E8 E1C9 
DDCB 0476 C032 024F C9DD 5E13 DDCB 0476 
C8F1 09C9 DDCB 0476 C019 10FD C9DD 740A 
09EB DDCB 0476 C078 B128 042B 1BED B8AF 
C9 
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* * * KEWDOS/80 Version 2.0 Model I ZAP Index * * * 
(Index listed in order of Filename) 



ZAP# Type 



Area Program 



Reference 



# 



5 Mandatory 
80 Mandatory 
14 Mandatory 

21 Mandatory 

52 Mandatory 
87 Mandatory 

53 Mandatory 
19 Mandatory 
74 Mandatory 

53 Optional 
27 Mandatory 
10 Mandatory 

1 Mandatory 

6 Optional 

22 Mandatory 
36 Information 

36 Information 
48 Mandatory 

54 Mandatory 
59 Mandatory 
86 Mandatory 

37 Mandatory 
9 Mandatory 
8 Mandatory 

37 Mandatory 

53 Optional 

58 Mandatory 

81 Mandatory 

2 Mandatory 
26 Mandatory 
39 Mandatory 

8 Optional 

37 Mandatory 
34 Mandatory 
34 Mandatory 
83 Mandatory 
51 Information 
83 Mandatory 

3 Mandatory 

38 Optional 
3 Mandatory 

38 Optional 
18 Mandatory 
33 Mandatory 
69 Mandatory 



User 

Utility 

BASIC 

BASIC 

BASIC 

BASIC 

User 

Utility 

Utility 

User 

Utility 

User 

User 

Utility 

Utility 

Utility 

Utility 

Utility 

Utility 

Utility 

Utility 

User 

User 

User 

User 

User 

Utility 

Utility 

User 

User 

User 

User 

User 

User 

User 

User 

User 

User 

User 

User 

User 

User 

Utility 

Utility 

Utility 



APL80/CMD 
AS POOL/ MAS 
BASIC/ CMD 
BASIC/ CMD 
BASIC/ CMD 
BASIC /CMD 
BRUN/CMD 



APL80/CMD 
*ASP,S function 
Basic Editing 

Marked & Fixed Item File Processing 
CLOSE command 
CMD"0" function 

Microsoft BASIC COMPILER v 5.23 
CHAINBLD/BAS Version 1 Format 
CHAINBLD/BAS Non-Displayed Character 
DIR/SYS Microsoft BASIC COMPILER v 5.23 
DISASSEM/CMD RTD Option 

DSMB/CMD Racet's DSM module DSMB/CMD 
EDIT/ CMD Microsoft's EDIT/ CMD 
EDTASM/CMD Disable LC to UC Conversion 
Cursor Display 
Documentation errors 
Tape I/O for Mod III disabled 
Filespec Response & <Sh-Lf-Arrow> 
Object Code to Cassette 
Correct & Restate ZAP #54 
File Close Problem 
BIONIC BASIC 
Racet's INFINITE BASIC 
Radio Shack's Model I PROFILE 
BIONIC BASIC 

Microsoft BASIC COMPILER v 5.23 
LMOFFSET/CMD Object Code Block Load 
LMOFFSET/CMD Appendage 
PENCIL/CMD ELECTRIC PENCIL 
PENCIL/ CMD ELECTRIC PENCIL 
ELECTRIC PENCIL 
Reenable Interrupts 
BIONIC BASIC 

Ryan-McFarland Corp COBOL v 1.3B 
RUNCOBOL/CMD Ryan-Mc Far land Corp COBOL v 1.3B 
SCR17/CTL Radio Shack's Model I SUPERSCRIPSIT 
SCRIPSIT Model I Cassette I/O 
SCRIPSIT/CMD Radio Shack's Model I SUPERSCRIPSIT 
SCRIPSIT/LC Radio Shack' b Model I SCRIPSIT 
SCRIPSIT/ LC Double Density & END command 
SCRIPSIT/UC Radio Shack's Model I SCRIPSIT 
SCRIPSIT/UC Double Density & END command 
SUPERZAP/CMD DM,P functions 
SUPERZAP/CMD DM & F functions 
SUPERZAP/CMD DMDB function 



EDTASM/CMD 

EDTASM/CMD 

EDTASM/CMD 

EDTASM/CMD 

EDTASM/CMD 

EDTASM/CMD 

EDTASM/CMD 

FIREUP/CMD 

IBLOAD/CMD 

IN IT 

INSTALL/ CMD 

L80/CMD 



PENCIL/CMD 
PROFILE/ CMD 
REMOVE/ CMD 
RS COBOL/ CMD 
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4 Optional DOS SYSO/SYS 

20 Mandatory DOS SYSO/SYS 

43 Mandatory DOS SYSO / SYS 

55 Optional DOS SYSO/SYS 

60 Mandatory DOS SYSO / SYS 
62 Mandatory DOS SYSO/SYS 
77 Optional DOS SYSO/SYS 
40 Mandatory DOS SYS2/SYS 
35 Mandatory DOS SYS3/SYS 

46 Optional DOS SYS3/ SYS 

12 Optional DOS SYS6/SYS 

13 Optional DOS SYS6/SYS 

15 Mandatory DOS SYS6/ SYS 
17 Mandatory DOS SYS6/SYS 

23 Mandatory DOS SYS6/SYS 

24 Mandatory DOS SYS6/SYS 
28 Mandatory DOS SYS6/ SYS 

31 Mandatory DOS SYS6/SYS 

32 Mandatory DOS SYS6/ SYS 

44 Mandatory DOS SYS6/SYS 

47 Mandatory DOS SYS6/ SYS 

56 Mandatory DOS SYS6/ SYS 

57 Mandatory DOS SYS6/ SYS 

76 Mandatory DOS SYS6/ SYS 

77 Optional DOS SYS6/SYS 

78 Optional DOS SYS6/SYS 
7 9 Mandatory DOS SYS6/ SYS 
85 Mandatory DOS SYS6/ SYS 

49 Mandatory DOS SYS8/ SYS 

61 Optional DOS SYS8/SYS 
64 Mandatory DOS SYS9/SYS 
42 Mandatory BASIC SYSll/SYS 

45 Mandatory BAS IC SYS1 2 / SYS 
20 Mandatory DOS SYS1 4/ SYS 

50 Optional DOS SYS14/SYS 
68 Mandatory DOS SYS14/SYS 

16 Mandatory DOS SYS16/SYS 
31 Mandatory DOS SYS16/SYS 
47 Mandatory DOS SYS16/SYS 
76 Mandatory DOS SYS16/SYS 

44 Mandatory DOS S YS1 7 / SYS 
57 Mandatory DOS SYS17/SYS 

1 4 Mandatory BAS IC SYS1 8/ SYS 

45 Mandatory ^ BASIC SYS18/SYS 
75 Mandatory *' BASIC SYS18/SYS 

66 Mandatory BASIC SYS1 9/SYS 

70 Mandatory BASIC SYS21 / SYS 
87 Mandatory BASIC SYS21 / SYS 
11 Mandatory User VC/CMD 

25 Mandatory User VC/CMD 

67 Mandatory User VC/CMD 

71 Mandatory User VC/CMD 



Increase Drive Power-Qn Delay 

ROUTE command 

ROUTE command 

Patch LC Keyboard Modification 

Disk Status Register Reads 

4445H call to DOS 

Double Density Write Precorap Logic 

Directory Entries 

CLOSE & KILL commands 

1 JKL': Graphics to Epson Printers 

Double Density Format Sensitivity 

To allow COPY of TRSDOS 1.2 (Mod 3) 

COPY Format 5 

COPY & FORMAT: DDSL parameter 

Granule Lockout Table in Directory 

FORMAT & COPY commands 

FORMAT: PFST parameter 

TRSDOS 2.3B (I) or TRSDOS 1.3 (III) 

TRSDOS 2.3B (I) or TRSDOS for Mod 3 

SYSTEM: BM parameter disabled 

PDRIVE: 8 Inch, Double Density 

COPY: CBF param & Model III TRSDOS 

COPY command 

Radio Shack's Double Density Board 

Double Density Write Precomp Logic 

Model I TRSDOS 2.7DD Diskettes 

COPY: TRSDOS 2.3B or Higher 

COPY Format 5 

DIR $ or DIR $0 

DIR: Remote Terminal Operators 

Chaining: /./5Y function 

RENUM function 

REF$ function 

ROUTE command 

PRINT & LIST: Control Characters 

CREATE: Old File's EOF 

PDRIVE error 

TRSDOS 2.3B (I) or TRSDOS 1.3 (III) 

PDRIVE: 8 Inch, Double Density 

Radio Shack's Double Density Board 

SYSTEM: BM parameter disabled 

COPY command 

Basic Editing 

REF$ function 

REF= statement 

Dynamic MERGE 

CMD"0" function 

CMD"0" function 

Radio Shack's Model I VISICALC 

Radio Shack's Model I VISICALC 

Model III VISICALC v VC-150Y0-T83 

Model III VISICALC v VC-160Y0-T83 



13-47 



7 Information DOS Command 

7 Information DOS Command 

7 Information DOS Command 

7 Information DOS Command 

29 Information DOS Command 

29 Information DOS Command 

30 Information DOS Command 
30 Information DOS Command 
36 Information DOS Command 
41 Information DOS Command 
41 Information DOS Command 
41 Information BASIC Command 
41 Information DOS Command 
51 Information DOS Command 
63 Information DOS Command 
63 Information User Command 
65 Information DOS Command 
65 Information DOS Command 
65 Information DOS Command 

72 Information DOS Command 

73 Information DOS Command 
82 Information DOS Command 
84 Information BASIC Command 
63 Information BASIC Commands 
63 Information DOS Commands 
63 Information DOS Features 

7 Information DOS General 

41 Information DOS General 

51 Information DOS General 

51 Information DOS General 

41 Information DOS Hardware 

63 Information DOS Hardware 

65 Information DOS Hardware 

7 Information DOS Mini-dos 

30 Information BASIC Utility 



ATTRIB: LRL=xxx Parameter 

ROUTE: display of routes 

COPY: DFO parameter 

FORMAT: RWF parameter 

PDRIVE & COPY: Double Density 

PDRIVE: OMIKRON & 8 Inch Drives 

Model I & Model III Data Exchange 

COPY: Formats 5 & 6 discussed 

Documentation Correction 

ROUTE: Documentation Correction 

Automatic Density Recognition 



• 



CMD"0" 
SYSTEM 

SYSTEM 



explanation 

AX parameter correction 

AJ-N explanation expanded 

DIR & FREE Error Messages 

Program Parameters 

COPY: Format 6 

GAT Overflow & CBF with FMT COPY 

LIST & PRIST: no graphics 

Accessing files on Model III TRSDOS 

Accessing Model I TRSDOS 2.3B & Up 

LC,Y & LC.N without Disk I/O 

CMD"0" & Multi-Dimension Arrays 

LOAD, RUN, MERGE & RENUM 

FORMS & SETCOM omission in Model I 

Main Memory, High Memory, MINI- DOS 

Reserved ZAP Areas in NEWD0S/80 

Cassette I/O 

TRSDOS 2.3B (I) & TRSDOS 1.3 (III) 

Chain Filename & /JCL entension 

CPU Speed Up Modifications 

LNW-80 Computer Users 

CPU Speed Up Modifications 

Illegal under DOS-CALL 

RENUM usage 
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APPENDIX A 



Understanding and learning to use the marked item and fixed item files speci- 
fied in chapter 8 has proved difficult to the normal NEWDOS/80 user; therefore 
appendices A and B have been included to provide examples and more explanation 
in an effort to ease this difficulty. Nothing in appendix A or B is to be 
construed as overriding the specifications provided in chapter 8; the two 
appendices are provided simply and exclusively for examples and elaboration. 

Appendix A was written by a user trying to cope with chapter 8 and is basically 
hiB understanding of marked item and fixed item files. 

Appendix B is the NEWDOS/80 author's attempt to provide example programs of the 
5 file sub-types: MF, MU, MI, FF and FI. 



File Positioning 

File Position (fp) is an operand in all NEWDOS/80 GETs and FUTs, and is speci- 
fied in section 8.4.1. When omitted, a null operand is assumed. The fp oper- 
and otherwise commonly consists of a special character, occasionally followed 
by other special characters and/ or expressions. One form of the fp operand 
consists of nothing more than a numeric expression. In the forms which follow, 
special characters are to be used as shown. In those forms showing a prefixing 
special character adjoining some other character string, the special character 
does not necessarily have to be contiguous with the rest of the expression; it 
may be separated from it by a blank or space. 

fp Value Meaning 

(null) 

If the file is an MU, MF or FF type file, and the REMRA is valid, the file 
is advanced to the next sequential record; in any other case, the current 
file position is not changed and processing continues from the position 
left at the termination of data transfer of the previous GET/PUT. Open 
leaves REMRA marked invalid for all file types, and sets current file 
position equal to (except for mode "E", which causes current file 
position to be set equal to the FPDE 1 s EOF value). The first sequential 
access for record segmented files always starts at current file position. 

* 

The current file position is not changed. This specification allows the 
continuation of processing of a particular record by a GET or PUT. It is 
primarily used to continue processing a record already partially read or 
written. For MU, MF and FF type files, it cannot be used to advance the 
file to the next sequential record, even though the file is actually 
already positioned at that record, having exhausted the bytes of the 
current record. To sequentially advance to the next record, use fp = 
(null). 
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&& 



trba 



1Z 



If the REMRA is valid, the file is positioned to process that record 
again; an error condition is raised if the REMRA is invalid. For MU, MF 
and FF type files, this specification allows the reprocessing of the re- 
cord currently heing processed, from the beginning, perhaps with different 
variable names or expressions in the IGELs. For MI and FI type files, it 
allows the reprocessing of the same data item group as was processed by 
the immediately preceeding GET/PUT. 

If the REMBA is valid, the file is positioned to begin processing at again 
it the point where the previous GET or PUT was at the end of its file 
positioning phase; an error condition is raised if the RQIBA is invalid. 
This specification allows the reprocessing of a particular group of data 
by a GET/PUT, and is primarily used to reposition a file for partial- 
record I/O. It functions in the same fashion for all NEWDOS/80 file 
types. 

This specification performs a "pseudo FIELD" operation* No data transfer 
takes place; the filearea FCB is not changed; the file does not have to be 
open when this fp is used. It is used with FF and FI files to allocate 
user data strings of fixed sizes from the BASIC string storage area in 
high memory. 

This specification is used only with PUTs, and has no effect on file 
positioning. It does however cause the current contents of a filearea 
buffer to be written to the diskette. It should be used whenever the data 
in the buffer is particularly sensitive. It may be used specifying the 
FAH of a PRINT file. 



This specification is similar to &, except that in addition the file's EOF 
is updated from the FCB to the FPDE. PUT fan,&& allows the programmer to 
force the EOF update to the FPDE without having to do a CLOSE. 

Using this form of fp specification causes GET/PUT processing to begin at 
the specified location in the file where rba is a BASIC expression 
evaluating to a RBA value. . For MU, MF and FF type files, the system 
checks to make sure that a record begins at the specified location. In 
the case of a MU file, the RBA value must point to an SOR item. This form 
of fp specification demands the greatest amount of care and premeditation 
on the programmer's part, as if it is used incorrectly, especially with FF 
and FI type files, it can be most disastrous. It is just about the only 
way to randomly access data stored in MI, MU and FI type files. 

This specification is basically the same as the Irba form except that the 
current EOF value is used as the RBA. It is commonly used to position a 
file for extension - that is, to add records/data to the end of the file. 
To extend a file it must be opened with mode "R"; mode "D" will yield an 
error if extension is attempted. 



#• 
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l$rba 

This specification allows the programmer to position the file for the next 
data transfer for that particular filearea, without regard to the specific 
access technique or verb used for the transfer; no data transfer to user 
data areas occurs with this specification. No IGEL may be referred to or 
included in the GET/PUT using this specification. The positioning 
resulting from the use of this specification doesn't become effective 
until the next INPUT/PRINT or GET/PUT, and then only if no additional 
positioning is specified. It can be used to position a file for random 
access in a program which uses a subroutine containing a single GET/PUT 
having a (null) fp to do all file access; such a program could process 
sequential groups of records randomly distributed throughout a file. 

The basic function of this specification is identical to l$rba, except 
that : it uses the current EOF value as the RBA. The GET/PUT using this 
specification must not refer to or include an IGEL. Again, the file 
position resulting from this specification doesn't take effect until the 
next INPUT/PRINT operation, or the next GET/POT (if another fp isn't 
specified) . 

I#rba 

Used only with PUT, this specification sets the filearea's EOF value equal 
to the value rba. For the real EOF value of the file to be altered, that 
is, the one in the FPDE, the filearea must either be closed or a PUT && 
statement executed. The EOF value provided must be rational for the file 
type involved. For MF and FF files it must be an integral multiple of the 
file's standard record length. 

m (Record Number) 

This specification is the same as the one supported by TRSDOS; rn is a 
numeric BASIC expression which evaluates to an integer value from 1 to 
32767, inclusive. The specified record number is converted to an RBA 
which is then used in the same functional manner as Irba. 

As mentioned above, certain forms for fp change REMBA, REMRA or EOF. For your 
convenience, the fp forms and their effects on these fields are summarized in 
the following decision table. 

fp REMBA REMRA EOF 

16 

2 6 

4 6 

4 6 

4 4 

4 4 

4 4 
1 6 
1 6 

5 4 
5 4 
4 1 
1 6 
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(null) 


1 


* 


1 


* 


3 


$ 


4 


% 


4 


& 


4 


&& 


4 


IRBA 


1 


IX 


1 


!$RBA 


5 


I$Z 


5 


I#RBA 


4 


RN 


1 



Meanings of codes in the matrix: 

1 — The field is set to the ERA resulting from that fp value. 

2 — If REMRA is invalid at the beginning of the statements execution, or 
it is an HI or FI file* the field is set to the RBA resulting from the fp 
value. In other words, it is set if the current file position is at the 
beginning of a record, otherwise it is unchanged. 

3 — The field is set equal to REMRA. 

4 — The field is not changed. 

5 — The field is set to an invalid value. 

6 — For output/update files, the field is changed if a PUT extends the 
file. 



Altogether, there are four areas in an FCB relevant to file positioning. These 
are: 

Current File Position 

This single field can be looked at as being 3 different values, 
depending upon where the GET/ PUT is in its processing: 

GPP1 

The file position at the start of GET/PUT execution. Unless the 
file has been closed and re-opened, it is the same value left as 
GPP3 from the last GET/PUT for that filearea. 

GPP2 

The resulting RBA value after positioning has been done, and 
prior to any data transfer. GPP2 is the value Baved as KEMBA 
and REMRA whenever these values are set. 

GPP3 

The RBA value after the last byte of data transfer, if any, real 
or byassed, has been accomplished. 

REMRA 

For MU, MF, FF and field item type files, it contains the RBA value 
of the beginning of the record in process. For MI, FI and 
IHPUT/PRIKT files, it is equal to REMBA. See GPP2 above. 

REMBA 

The RBA value where the previous data- transferring GET/PUT began its 
data transfer. If the file is record-segmented, and REMBA is at the 
start of a record, REMRA is set equal to REMBA. See GPP2 above. 



EOF 

The RBA value of the last byte of data in the file, plus 1. For MU, 
MF, FF and field item type files, it effectively points to the next 
sequential record to be written to the file. For MI, FI and 
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